Amap Maps MCP Server

🚀 高德地圖 MCP 服務器

本項目是用於高德地圖 API 的 MCP 服務器，可支持任意 MCP 協議的客戶端，讓用戶輕鬆利用高德地圖 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": "您在高德官網上申請的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 服務器是一個支持任意 MCP 協議客戶端的服務器，用戶可以輕鬆利用它進行各種基於位置的服務。

📝 如何使用高德地圖 MCP 服務器？

要使用高德地圖 MCP 服務器，您可以在兼容的客戶端（如 Cursor）中進行配置。具體操作是複製您的 API 密鑰，並按照文檔中的說明設置服務器命令。

✨ 高德地圖 MCP 服務器的主要特性

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

📋 高德地圖 MCP 服務器的使用場景

• 將地理座標轉換為行政地址。
• 規劃騎行、步行或駕車路線。
• 根據用戶定義的條件搜索附近的興趣點。

❓ 常見問題解答

高德地圖 MCP 服務器提供哪些類型的位置服務？

高德地圖 MCP 服務器提供地理編碼、天氣信息、距離測量以及多種交通方式的路線規劃服務。

請求數量是否有限制？

請求限制取決於 API 密鑰和所使用的具體服務。詳細信息請參考高德官方文檔。

如何獲取 API 密鑰？

您可以在高德開發者平臺上創建項目來獲取 API 密鑰。

💻 在 Cursor 中配置

建議使用最新版本的 Cursor 客戶端。

🔌 接入配置

複製 API 密鑰的地址： 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": "您在高德官網上申請的key"
      }
    }
  }
}