AMap (Gaode Maps)

🚀 AMap 坐标转换服务器 MCP 服务

本项目是一个用于 AMap 坐标转换和地点搜索的模型上下文协议 (MCP) 服务器。它提供了强大的工具，可实现坐标在不同系统间的转换，还能借助 AMap API 进行地点搜索，为相关开发工作带来便利。

🚀 快速开始

本服务器提供了一系列实用工具，能满足不同场景下的坐标转换与地点搜索需求。

✨ 主要特性

工具

• coordinate_convert：可在不同的坐标系（GPS、mapbar、baidu、autonavi）之间转换坐标。
• keyword_search：支持通过关键词搜索地点。
• around_search：能够根据特定位置搜索周边的地点。
• polygon_search：可以在给定的多边形区域内搜索地点。
• id_search：可通过地点 ID 搜索特定地点。
• aoi_boundary_query：用于查询兴趣区（AOI）的边界。

📦 安装指南

开发

1. 安装依赖：

npm install

2. 构建服务器：

npm run build

3. 带有自动重建功能的开发：

npm run watch

安装

要与 Claude Desktop 一起使用，请添加服务器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json%

{
  "mcpServers": {
    "amap-coordinate-server": {
      "command": "/path/to/amap-coordinate-server/build/index.js",
      "env": {
        "AMAP_API_KEY": "YOUR_AMAP_API_KEY"
      }
    }
  }
}

⚠️ 重要提示

您需要获得 AMap API 密钥并将其设置为 AMAP_API_KEY 环境变量。

调试

由于 MCP 服务器通过标准输入输出进行通信，调试可能会有挑战性。我们推荐使用 MCP Inspector，这是一个可以通过以下命令运行的包工具：

npm run inspector

Inspector 将提供一个可以在浏览器中访问调试工具的 URL。