Amap マップ

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に関するFAQ

• 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.