Amap MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Amap MCP Server What's the fastest driving route from 武汉天地 to 天河机场?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
高德地图 MCP Server · Amap MCP Server
🇬🇧 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
Tool | Description |
| Address ↔ Coordinates (forward & reverse) |
| 🚗 Driving directions with multi-strategy (fastest/cheapest/shortest/avoid-congestion) |
| 🚌 Public transit directions (bus + subway) with cost & transfer info |
| 🚶 Walking directions |
| 🚲 Cycling directions |
| 🔍 POI search by keyword (restaurants, hotels, gas stations, etc.) |
| 📍 Nearby search within a radius |
| 📏 Batch distance/time measurement (up to 10 origins) |
| 🏆 Rating-based POI ranking — like Amap's "Street Ranking". Search by keyword, sort by rating/cost, top N |
| 📋 POI detail lookup — get full info (rating, cost, hours, photos, reviews) by POI ID |
| 🌤 Weather query — real-time or 4-day forecast for any Chinese city |
| 🏠 IP-based coarse location (city level) |
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 installConfiguration
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 天河机场"
"Find the top 10 highest-rated cocktail bars within 5km of 三乡, sorted by rating"
API Reference
All tools use the Amap Web Service API v3/v4. See Amap API Docs for details.
Strategy | Driving | Transit |
0 | Speed first | Fastest |
1 | Cost first | Cheapest |
2 | Distance first | Fewest transfers |
3 | Avoid congestion | Least walking |
4 | Avoid congestion + Speed first | — |
5 | Multi-strategy compare | No subway |
License
MIT © 2026 曾泽瑞 (Zeng Zerui)
Related MCP server: google-maps-mcp-server
🇨🇳 中文
一个 MCP (Model Context Protocol) 服务器,封装了高德地图 Web 服务 API,为 Claude Code 等 AI 助手提供 9 个地图工具:地理编码、四种路径规划(驾车/公交/步行/骑行)、POI 搜索、周边搜索、距离测量、IP 定位。
为什么做这个: 截至 2026 年 6 月,Smithery 等 MCP 市场上没有任何高德/百度地图的 MCP Server。Google Maps MCP 有,但国内路线覆盖差。这个项目填补了空白。
功能
工具 | 说明 |
| 地址 ↔ 经纬度互转(正向 + 逆地理编码) |
| 🚗 驾车路径规划,支持多策略(最快/最省钱/最短/躲避拥堵) |
| 🚌 公交地铁规划,含票价、换乘次数、步行段 |
| 🚶 步行导航 |
| 🚲 骑行导航 |
| 🔍 关键词搜索地点(餐厅、酒店、加油站等) |
| 📍 周边搜索(指定半径) |
| 🏆 评分榜单——类似高德「扫街榜」,按评分/价格排序,Top N |
| 📋 POI 详情——根据 ID 获取完整信息(评分/人均/营业时间/图片/评论) |
| 🌤 天气查询——全国城市实时天气或 4 日预报 |
| 📏 批量测距(最多 10 个起点同时比较) |
| 🏠 IP 粗略定位(城市级) |
前置条件
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 公里内有没有评分高的火锅店?"
"从汉口站到武昌站怎么坐地铁最快?"
"帮我算一下从家、公司和火车站分别到天河机场的距离和时间"
"三乡附近 5 公里内评分最高的 10 家清吧有哪些?按评分排"
驾车策略
策略 | 含义 |
0 | 速度优先(最快) |
1 | 费用优先(不走高速) |
2 | 距离优先 |
3 | 躲避拥堵(不走快速路) |
4 | 躲避拥堵 + 速度优先 |
5 | 多策略对比 |
公交策略
策略 | 含义 |
0 | 最快捷 |
1 | 最经济 |
2 | 最少换乘 |
3 | 最少步行 |
5 | 不乘地铁 |
已知限制
坐标格式:
lng,lat(经度在前)—— 高德特有,非国际惯例实时路况需要企业版权限,当前使用静态时间估算
公交跨城规划有限支持
海外地址覆盖有限,主要覆盖中国大陆
License
MIT © 2026 曾泽瑞 (Zeng Zerui)
Available Tools
12 toolsamap_direction_bicyclingA
骑行路径规划。返回骑行路线——总距离、预计时间、沿途道路。
Inputs: origin (required), destination (required).
amap_direction_drivingA
驾车路径规划。传入起点/终点(支持坐标或地址),返回最优路线——含总距离、预计时间、沿途步骤、过路费、红绿灯数。strategy: 0=速度优先, 1=费用优先, 2=距离优先, 3=躲避拥堵(不走快速路), 4=躲避拥堵&速度优先, 5=多策略对比。
Inputs: origin (required), destination (required), strategy, avoidroad, +4 more.
amap_direction_transitA
公交/地铁路径规划。传入起点/终点和所在城市,返回公交换乘方案——含步行段、公交线路、地铁线路、换乘次数、总耗时、票价。
Inputs: city (required), origin (required), destination (required), date, +3 more.
amap_direction_walkingA
步行路径规划。返回步行路线——总距离、预计时间、每一步指引。
Inputs: origin (required), destination (required).
amap_distanceB
距离测量。计算多个起点到一个终点的驾车距离和时间。用于比较不同出发点的可达性。
Inputs: origins (required), destination (required), type.
amap_geocodeA
地址 ↔ 经纬度互转。传入 address 将地址解析为经纬度;传入 location(lng,lat)做逆地理编码返回结构化地址。做任何路径规划前,先用此工具获取起点/终点的坐标。
Inputs: city, address, location.
amap_ip_locationA
IP 定位。获取当前网络出口的粗略位置(城市级别),用于快速确定「我在哪」。无需任何参数。
Inputs: no named parameters.
amap_poi_aroundA
周边搜索。给定中心点和半径,搜索周边POI——找附近的餐厅、停车场、银行等。
Inputs: location (required), types, offset, radius, +2 more.
amap_poi_detailA
POI 详情查询。根据 POI ID 获取详细信息——评分、人均、营业时间、图片。配合搜索/扫街榜使用。
Inputs: id (required).
amap_poi_rankingA
POI 评分榜单 —— 类似高德「扫街榜」。搜索指定区域/城市内某类POI,按评分/价格排序,返回Top N。找好餐厅、好酒吧、热门打卡地就用这个。
Inputs: keywords (required), top, city, sort, +4 more.
amap_poi_searchB
POI(兴趣点)搜索。按关键词或类型搜索地点——餐厅、酒店、景点、加油站、停车场等。支持城市范围过滤。
Inputs: keywords (required), city, page, types, +2 more.
amap_weatherA
天气查询。查询指定城市的实时天气或未来预报。
Inputs: city (required), extensions.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool targets a distinct function: geocoding, four direction modes, distance, POI search/around/ranking/detail, IP location, and weather. The naming with amap_ plus domain makes each tool's purpose immediately identifiable, with no overlapping tools.
All tool names follow a consistent pattern: lowercase snake_case with the amap_ prefix. Direction tools use amap_direction_*, POI tools use amap_poi_*, and other utilities are simple nouns. This is predictable and easy to navigate.
12 tools is appropriate for a comprehensive map service, covering geocoding, routing, place search, and utilities without feeling bloated. Each tool serves a clear purpose.
The server covers core mapping workflows: geocoding, multi-modal directions, distance calculation, POI search and details, plus useful extras like weather and IP location. Missing advanced features like traffic conditions or static map rendering are minor gaps that don't hinder common use cases.
Maintenance
Related MCP Connectors
Geocoding, routing, isochrones, traffic, weather, and place search for AI agents. 19 MCP tools.
MCP server for China administrative divisions: province/city/district lookup, adcode resolution and
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server for Japan geodata: cadastral lot numbers (chiban) and reverse geocoding, for AI agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceNon-official Model Context Protocol server that enables interaction with AMap's location services through clients like Cursor, Claude Desktop, Cline, and Windsurf.12MIT
- AlicenseAqualityDmaintenanceProduction-ready MCP server for Google Maps Platform APIs, providing 11 tools for directions, places, geocoding, traffic, and road data to empower AI agents with location intelligence.1134 PyPI4Apache 2.0
- AlicenseBqualityCmaintenanceAn MCP server that wraps multiple vendors' Coding Plan services (iFlytek Spark, Volcengine) to provide code review, plan review, and multi-turn dialogue for AI coding tools like Claude Code.4MIT
- AlicenseAqualityDmaintenance这是一个面向中文圈的MCP服务器,将中国互联网常用能力(如地图、快递、RSS、B站等)封装为标准MCP工具,方便AI Agent安全调用。132MIT