Amap Karten

Was ist Amap Maps?

Amap Maps ist ein Server, der jeden MCP-Protokoll-Client unterstützt und es den Benutzern ermöglicht, den Amap Maps MCP-Server für verschiedene standortbasierte Dienste einfach zu nutzen.

Wie benutze ich Amap Maps?

Um Amap Maps zu verwenden, konfigurieren Sie es in einem kompatiblen Client wie Cursor, indem Sie Ihren API-Schlüssel kopieren und den Serverbefehl gemäß der Dokumentation einrichten.

Hauptmerkmale von Amap Maps

• Unterstützt mehrere Standortdienste, einschließlich Geokodierung, Wetter und Distanzmessung.
• Bietet APIs für verschiedene Transportmodi, einschließlich Gehen, Fahren und öffentliche Verkehrsmittel.
• Ermöglicht detaillierte Suchen nach Sehenswürdigkeiten (POIs) basierend auf Schlüsselwörtern oder Standort.

Anwendungsfälle von Amap Maps

1. Umwandlung geografischer Koordinaten in administrative Adressen.
2. Planung von Routen für Radfahren, Gehen oder Fahren.
3. Suche nach nahegelegenen Sehenswürdigkeiten basierend auf benutzerdefinierten Kriterien.

FAQ zu Amap Maps

• Welche Arten von Standortdiensten bietet Amap Maps an?

  Amap Maps bietet Geokodierung, Wetterinformationen, Distanzmessung und Routenplanung für verschiedene Transportmodi an.

• Gibt es eine Begrenzung für die Anzahl der Anfragen, die ich stellen kann?

  Die Nutzungslimits hängen vom API-Schlüssel und dem spezifischen Dienst ab, der verwendet wird. Bitte beziehen Sie sich auf die Amap-Dokumentation für Details.

• Wie erhalte ich einen API-Schlüssel?

  Sie können einen API-Schlüssel erhalten, indem Sie ein Projekt auf der Amap-Entwicklerplattform erstellen.

Clients supporting the MCP protocol (e.g., Cursor, Claude, Cline) can easily use the Amap Maps MCP server. Currently, it supports MCP (SSE) and Node.js I/O connection methods.

1. Accessing MCP Service via SSE on the Cursor Platform

1.1 Install Cursor

It is recommended to use the latest version of the Cursor client. Install Cursor.

Note: Please log in to your Cursor personal account to use large model features.

1.2 Configure SSE Connection in Cursor Settings

1.3 Add a New MCP Server Configuration

Obtain a key.

{
  "mcpServers": {
    "amap-amap-sse": {
      "url": "https://mcp.amap.com/sse?key=<your_key>"
    }
  }
}

1.4 Check MCP Service Tool Status in Cursor Settings

Tip: If a "Client closed" error occurs, click the Enabled button to resolve it, as shown below:

1.5 Select a Large Model for Better Experience

It is recommended to choose claude-3.7-sonnet.

1.6 Model Interaction Mode: Select Agent Mode

Press CTRL/CMD + L to open the dialog box on the right side of the editor.

1.7 Start Using

Learn how to use Amap MCP for planning scheme design and map visualization scenarios. Refer to Application Cases.

2. Accessing MCP Service via SSE with Spring AI

2.1 Configuration

spring.ai.mcp.client.connection-timeout=60s
spring.ai.mcp.client.type=ASYNC
# Note: Do not include the Amap SSE connection in the configuration file

2.2 Add Configuration Class

@Configuration
public class McpConfig {

    @Bean
    public List<NamedClientMcpTransport> mcpClientTransport() {
        McpClientTransport transport = HttpClientSseClientTransport
                .builder("https://mcp.amap.com")
                .sseEndpoint("/sse?key=<your_key>")
                .objectMapper(new ObjectMapper())
                .build();

        return Collections.singletonList(new NamedClientMcpTransport("amap", transport));
    }
}

2.3 Usage

@Autowired
List<McpAsyncClient> mcpAsyncClients;

@RequestMapping("/test")
public Mono<McpSchema.CallToolResult> test() {
    var mcpClient = mcpAsyncClients.get(0);
    
    return mcpClient.listTools()
            .flatMap(tools -> {
                logger.info("tools: {}", tools);
                
                return mcpClient.callTool(
                        new McpSchema.CallToolRequest(
                                "maps_weather",
                                Map.of("city", "Beijing")
                        )
                );
            });
}

2.4 Start Using

Learn how to use Amap MCP for planning scheme design and map visualization scenarios. Refer to Application Cases.

3. Accessing MCP Service via Node.js I/O on the Cursor Platform

3.1 Install Node.js

Download the Node.js application suitable for your operating system.

Tip:

1. Ensure Node.js is installed and check that the local Node.js version is v22.14.0 or higher. It is recommended to use v22.14.0 or above for optimal compatibility and performance.
2. Verify that the npm registry is set to the default source (https://registry.npmjs.org/).

Check command:

npm config get registry

3.2 Install Cursor

It is recommended to use the latest version of the Cursor client. Install Cursor.

Note: Please log in to your Cursor personal account to use large model features.

3.3 Configure MCP Server in Cursor Settings

3.4 Add a New MCP Server Configuration

Obtain a key.

{
  "mcpServers": {
    "amap-maps": {
      "command": "npx",
      "args": ["-y", "@amap/amap-maps-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "<your_key>"
      }
    }
  }
}

3.5 Check MCP Service Tool Status in Cursor Settings

The MCP Server — amap-maps Tools status is normal and available, as shown above.

Tip: If a "Client closed" error occurs, click the Enabled button to resolve it, as shown below:

3.6 Select a Large Model for Better Experience

It is recommended to choose claude-3.7 unitàsonnet.

3.7 Model Interaction Mode: Select Agent Mode

Press CTRL/CMD + L to open the dialog box on the right side of the editor.

3.8 Start Using

Learn how to use Amap MCP for planning scheme design and map visualization scenarios. Refer to Application Cases.