高德地图 MCP Server · Amap MCP Server

English | 中文

🇬🇧 English

A Model Context Protocol (MCP) server that wraps the Amap (高德地图) Web Service APIs, giving AI assistants like Claude Code 9 map tools: geocoding, route planning (driving/transit/walking/cycling), POI search, nearby search, distance measurement, and IP location.

Why this exists: There was no publicly available Amap/Baidu Maps MCP Server on Smithery or anywhere else (as of 2026-06). Google Maps MCP exists but its China coverage is poor. This fills that gap.

Features

Prerequisites

• Node.js ≥ 18

• Amap API Key (Web Service type, NOT Web JS API)

  • Free tier: 5,000 calls/day per endpoint

Installation

git clone https://github.com/zengzeruidd-a11y/amap-mcp-server.git
cd amap-mcp-server
npm install

Configuration

Add to your Claude Code .mcp.json (global: ~/.claude/.mcp.json or project: .mcp.json):

{
  "amap": {
    "command": "node",
    "args": ["/path/to/amap-mcp-server/server.js"],
    "env": {
      "AMAP_KEY": "your-amap-api-key-here"
    }
  }
}

Restart Claude Code. The 9 tools will appear automatically.

For other MCP-compatible clients (Cursor, Windsurf, etc.), configure via their respective MCP settings.

Usage Examples

Once configured, ask Claude:

"What's the fastest driving route from 武汉天地 to 天河机场 on Saturday morning?"

"Find hotpot restaurants within 2km of 光谷广场, sorted by rating"

"How do I get from 汉口站 to 武昌站 by subway?"

"Compare distances from my home, office, and the train station to 天河机场"

API Reference

All tools use the Amap Web Service API v3/v4. See Amap API Docs for details.

License

MIT © 2026 曾泽瑞 (Zeng Zerui)

Related MCP server: GIS Data Conversion MCP

🇨🇳 中文

一个 MCP (Model Context Protocol) 服务器，封装了高德地图 Web 服务 API，为 Claude Code 等 AI 助手提供 9 个地图工具：地理编码、四种路径规划（驾车/公交/步行/骑行）、POI 搜索、周边搜索、距离测量、IP 定位。

为什么做这个： 截至 2026 年 6 月，Smithery 等 MCP 市场上没有任何高德/百度地图的 MCP Server。Google Maps MCP 有，但国内路线覆盖差。这个项目填补了空白。

功能

前置条件

• Node.js ≥ 18

• 高德开放平台 API Key（选 Web 服务 类型，不是 Web 端 JS API）

  • 免费额度：每个接口 5,000 次/天

安装

git clone https://github.com/zengzeruidd-a11y/amap-mcp-server.git
cd amap-mcp-server
npm install

配置

在 Claude Code 的 .mcp.json 中添加（全局：~/.claude/.mcp.json 或项目级：.mcp.json）：

{
  "amap": {
    "command": "node",
    "args": ["/path/to/amap-mcp-server/server.js"],
    "env": {
      "AMAP_KEY": "你的高德API密钥"
    }
  }
}

重启 Claude Code，9 个工具自动加载。

其他 MCP 兼容客户端（Cursor、Windsurf 等）请参考各自的 MCP 配置方式。

使用示例

配置好后，直接问 Claude：

"从武汉天地开车到天河机场，周六上午出发，哪条路线最快？"

"光谷广场周边 2 公里内有没有评分高的火锅店？"

"从汉口站到武昌站怎么坐地铁最快？"

"帮我算一下从家、公司和火车站分别到天河机场的距离和时间"

驾车策略

公交策略

已知限制

• 坐标格式：lng,lat（经度在前）—— 高德特有，非国际惯例

• 实时路况需要企业版权限，当前使用静态时间估算

• 公交跨城规划有限支持

• 海外地址覆盖有限，主要覆盖中国大陆

License

MIT © 2026 曾泽瑞 (Zeng Zerui)