Amap 地圖

什麼是 Amap 地圖？

Amap 地圖是一個支持任何 MCP 協議客戶端的伺服器，允許用戶輕鬆利用 Amap 地圖 MCP 伺服器提供各種基於位置的服務。

如何使用 Amap 地圖？

要使用 Amap 地圖，請在兼容的客戶端（如 Cursor）中進行配置，通過複製您的 API 密鑰並按照文檔中指定的設置伺服器命令。

Amap 地圖的主要特點

• 支持多種位置服務，包括地理編碼、天氣和距離測量。
• 提供各種交通模式的 API，包括步行、駕駛和公共交通。
• 允許根據關鍵字或位置詳細搜索興趣點（POI）。

Amap 地圖的使用案例

1. 將地理坐標轉換為行政地址。
2. 計劃騎行、步行或駕駛的路線。
3. 根據用戶定義的標準搜索附近的興趣點。

Amap 地圖的常見問題解答

• Amap 地圖提供哪些類型的位置服務？

  Amap 地圖提供地理編碼、天氣信息、距離測量和各種交通模式的路線規劃。

• 我可以發送的請求數量有限制嗎？

  使用限制取決於 API 密鑰和所使用的具體服務。請參閱 Amap 文檔以獲取詳細信息。

• 我如何獲取 API 密鑰？

  您可以通過在 Amap 開發者平台上創建項目來獲取 API 密鑰。

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.