amap-maps-mcp
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-maps-mcp Get driving directions from Beijing to Shanghai"
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.
amap-maps-mcp
高德地图 Web Service API 的 MCP Server。
相比官方包的主要改进:
路径规划全部使用路径规划 2.0(v5 接口)
驾车规划支持完整参数:
strategy(16 种算路策略)、waypoints(途经点)、plate(车牌限行规避)、avoidpolygons(避让区域)、show_fields等公交规划支持:
strategy、nightflag、date/time等POI 搜索支持分页、
types、citylimit参数(官方包的types参数实际无效)
工具列表
工具 | 说明 |
| 地理编码(地址 → 坐标) |
| 逆地理编码(坐标 → 地址) |
| IP 定位 |
| 天气查询 |
| POI 关键词搜索 |
| POI 周边搜索 |
| POI 详情 |
| 驾车路径规划(v5) |
| 步行路径规划(v5) |
| 骑行路径规划(v5) |
| 公共交通路径规划(v5) |
| 距离测量 |
Related MCP server: Amap MCP Server
前置要求
在高德开放平台申请 Web 服务类型的 API Key。
使用方法
npx(无需安装)
{
"mcpServers": {
"amap": {
"command": "npx",
"args": ["-y", "amap-maps-mcp"],
"env": {
"AMAP_MAPS_API_KEY": "你的APIKey"
}
}
}
}全局安装
npm install -g amap-maps-mcp{
"mcpServers": {
"amap": {
"command": "amap-maps-mcp",
"env": {
"AMAP_MAPS_API_KEY": "你的APIKey"
}
}
}
}坐标系说明
高德地图使用 GCJ-02 坐标系。GPS 设备输出的 WGS-84 坐标需要先转换,可使用高德的坐标转换 API。
License
MIT
Available Tools
12 toolsmaps_around_searchA
以某坐标为中心,在指定半径内搜索周边 POI。(搜索POI 2.0,v5接口)
Inputs: location (required), types, radius, region, +6 more.
maps_bicyclingA
骑行路径规划(路径规划 2.0,v5 接口)。考虑单行线、封路等。
Inputs: origin (required), destination (required), show_fields, alternative_route.
maps_direction_drivingB
驾车路径规划(路径规划 2.0,v5 接口)。支持途经点、算路策略、车牌限行规避、避让区域等。
Inputs: origin (required), destination (required), ferry, plate, +8 more.
maps_direction_transit_integratedA
公共交通路径规划(路径规划 2.0,v5 接口)。涵盖公交、地铁、火车、跨城交通。
Inputs: city1 (required), origin (required), destination (required), ad1, +10 more.
maps_direction_walkingA
步行路径规划(路径规划 2.0,v5 接口)。支持室内算路、多备选路线。
Inputs: origin (required), destination (required), isindoor, origin_id, +3 more.
maps_distanceB
测量起点到终点的距离(直线距离、驾车距离或步行距离)。
Inputs: origins (required), destination (required), type.
maps_geoC
地理编码:将结构化地址转换为高德经纬度坐标(GCJ-02)。支持中文地址、地标名称。
Inputs: address (required), city.
maps_ip_locationA
根据 IP 地址查询所在城市及大致范围。
Inputs: ip (required).
maps_regeocodeA
逆地理编码:将高德经纬度坐标(GCJ-02)转换为详细结构化地址和行政区划信息。
Inputs: location (required).
maps_search_detailA
根据 POI ID 查询详细信息,包括地址、电话、营业时间、照片等。支持一次传入多个 ID。(搜索POI 2.0,v5接口)
Inputs: id (required), show_fields.
maps_text_searchC
根据关键词搜索 POI(兴趣点),如餐厅、加油站、景点等。(搜索POI 2.0,v5接口)
Inputs: keywords (required), types, region, page_num, +3 more.
maps_weatherA
查询指定城市未来几天的天气预报。
Inputs: city (required).
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 clearly distinct map function: geocoding, reverse geocoding, weather, POI search by keyword, POI search by radius, POI detail, route planning modes, and distance. Even the similar POI tools are clearly separated by input type and purpose.
All tools share a consistent maps_ prefix and use readable snake_case names. However, maps_bicycling breaks the maps_direction_* pattern used by the other route tools, and a few names like maps_geo and maps_weather are standalone nouns rather than verb-noun actions.
Twelve tools is well-scoped for a map and location server, covering geocoding, POI search, route planning, weather, distance, and IP location. Each tool earns its place and none feel redundant.
The tool set covers the core map-query workflow end to end: address-to-coordinate, coordinate-to-address, multiple POI search modes, POI detail retrieval, all major route types, and distance measurement. No obvious critical workflow is missing.
Maintenance
Related MCP Connectors
Geocode, reverse-geocode, autocomplete, route and search places.
Routing, geocoding, places, matrix and map tools for location-aware AI workflows.
Mobility, geocoding and nearby urban services for AI agents.
Geoapify MCP — wraps the Geoapify Location Platform (geoapify.com)
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables location-based services through AMap/AutoNavi Maps API including geocoding, weather information, route planning, and POI searches. Supports multiple transportation modes and provides detailed geographic data for Chinese locations.124Mulan Permissive Software , Version 2
- FlicenseNot gradedqualityDmaintenanceProvides comprehensive geographic information services and route planning for AI agents via the Amap (Gaode Maps) API. It supports geocoding, multi-modal navigation, POI searches, and administrative region queries.3-
- AlicenseAqualityDmaintenanceA 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.1234 npm1MIT
- AlicenseAqualityDmaintenanceProvides map services such as geocoding, POI search, and route planning through the Amap API, enabling AI applications to interact with map data via natural language.12MIT