高德地图

什么是 Amap Maps？

Amap Maps 是一个支持任何 MCP 协议客户端的服务器，允许用户轻松利用 Amap Maps MCP 服务器进行各种基于位置的服务。

如何使用 Amap Maps？

要使用 Amap Maps，请在兼容的客户端（如 Cursor）中进行配置，复制您的 API 密钥并按照文档中指定的设置服务器命令。

Amap Maps 的主要特点

• 支持多种位置服务，包括地理编码、天气和距离测量。
• 提供多种交通方式的 API，包括步行、驾驶和公共交通。
• 允许根据关键字或位置进行详细的兴趣点（POI）搜索。

Amap Maps 的使用案例

1. 将地理坐标转换为行政地址。
2. 规划骑行、步行或驾驶的路线。
3. 根据用户定义的标准搜索附近的兴趣点。

Amap Maps 常见问题解答

• Amap Maps 提供哪些类型的位置服务？

  Amap Maps 提供地理编码、天气信息、距离测量和各种交通方式的路线规划。

• 我可以发起的请求数量有限制吗？

  使用限制取决于 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.