JinDaGe - amap-maps-mcp-server MCP Details

article

README

🚀 高德地图 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"
      }
    }
  }
}

amap-maps-mcp-server