Amap Maps MCP Server

🚀 高德地图MCPサーバー

高德地图API用のMCPサーバーです。

🚀 クイックスタート

📦 インストール

APIキー

高德地図APIキーを取得してください： https://lbs.amap.com/api/webservice/create-project-and-key.

NPX

{
  "mcpServers": {
    "amap-maps": {
      "command": "npx",
      "args": ["-y", "@masx200/amap-maps-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "あなたが高德公式サイトで申請したキー"
      }
    }
  }
}

環境変数

設定可能な環境変数は以下の通りです：

• AMAP_MAPS_API_KEY: 高德地図APIキー（必須）
• HTTP_API_TOKEN: HTTP APIアクセストークン（オプション）
• HTTP_API_PORT: HTTPサーバーのポート番号（オプション、デフォルトは3000）

Streamable-HTTPプロトコルサーバー

このプロジェクトは、MCPサーバーとして実行するだけでなく、独立したstreamable-HTTPプロトコルサーバーを起動することもサポートしています：

直接起動

node ./build/streamable-http.js

環境変数を使用した設定

# ポートを設定（デフォルトは3000）
export HTTP_API_PORT=3000

# アクセストークンを設定（オプション）
export HTTP_API_TOKEN=your-secret-token

# 高德地図APIキーを設定
export AMAP_MAPS_API_KEY=your-amap-api-key

# サーバーを起動
node ./build/streamable-http.js

使用例

起動後、サーバーは http://localhost:3000 で動作し、以下のエンドポイントをサポートします：

• POST /mcp - MCPプロトコル通信エンドポイント
• streamable-httpプロトコルのリアルタイムデータストリームをサポート

HTTP_API_TOKEN を設定した場合は、リクエストヘッダーに以下を追加してください：

Authorization: Bearer your-secret-token

📚 ドキュメント

高德地図とは何ですか？

高德地図は、任意のMCPプロトコルクライアントをサポートするサーバーであり、ユーザーが様々な位置ベースのサービスに高德地図MCPサーバーを簡単に利用できるようにします。

高德地図をどのように使用しますか？

高德地図を使用するには、互換性のあるクライアント（Cursorなど）で、APIキーをコピーし、ドキュメントに指定されたサーバーコマンドを設定します。

高德地図の主な機能は何ですか？

地理コーディング、天気、距離測定などの複数の位置サービスをサポートしています。徒歩、ドライブ、公共交通機関などの様々な交通手段のAPIを提供します。キーワードまたは位置に基づいて興味のある地点（POI）を詳細に検索できます。

高德地図の使用例は何ですか？

地理座標を行政住所に変換する。自転車、徒歩、または車でのルートを計画する。ユーザーが定義した基準に基づいて近くの興味のある地点を検索する。

高德地図に関するよくある質問

高德地図はどのような種類の位置サービスを提供しますか？

高德地図は、地理コーディング、天気情報、距離測定、および様々な交通手段のルート計画を提供します。

リクエスト数に制限はありますか？

使用制限はAPIキーと使用する特定のサービスによって異なります。詳細は高德のドキュメントを参照してください。

APIキーをどのように取得しますか？

高德開発者プラットフォームでプロジェクトを作成することでAPIキーを取得できます。

コンテンツ

任意のMCPプロトコルのクライアント（Cursor、Claude、Clineなど）は、高德地図MCPサーバーを簡単に使用できます。以下はCursorプラットフォームを例に説明します。

Cursorでの設定

最新バージョンのCursorクライアントを使用することをお勧めします。

接続設定

キーをコピーします。 https://lbs.amap.com/api/mcp-server/create-project-and-key

{
  "mcpServers": {
    "amap-maps": {
      "command": "npx",
      "args": ["-y", "@masx200/amap-maps-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "あなたが高德公式サイトで申請したキー"
      }
    }
  }
}