Overview
What is 高德地图 MCP Server?
高德地图 MCP Server is an MCP server that integrates with the Amap (高德地图) API. It provides a set of tools for geocoding, location services, route planning, distance measurement, and POI search. The server is intended for developers who want to use Amap location data within an MCP-enabled client.
How to use 高德地图 MCP Server?
Configure the server in your MCP client with a valid AMAP_MAPS_API_KEY obtained from the 高德开放平台. Three transport modes are supported: stdio (default), sse, and streamable-http. Use uvx amap-mcp-server to run it locally with SSE or Streamable HTTP.
Key features of 高德地图 MCP Server
- Convert coordinates to addresses and vice versa (regeocode, geo).
- IP geolocation and weather queries by city.
- Route planning for cycling, walking, driving, and public transit.
- Distance measurement between coordinates (driving, walking, spherical).
- POI search by keywords, around a location, or by specific ID.
Use cases of 高德地图 MCP Server
- Geocode an address to obtain its latitude and longitude.
- Get the current weather for a city using its name or adcode.
- Plan a cycling or walking route by address or coordinates.
- Search for nearby points of interest within a given radius.
- Measure the distance between two locations for travel planning.
FAQ from 高德地图 MCP Server
Do I need an API key to use this server?
Yes, you must set the environment variable AMAP_MAPS_API_KEY with a valid API key from the 高德开放平台.
What transport protocols does the server support?
The server supports three transports: stdio (default), sse, and streamable-http. Configuration examples for each are provided in the README.
Can I use this server for cross-city public transit planning?
Yes, the transit integrated tool requires you to specify both origin and destination cities when planning a cross-city route.
Where does the location data come from?
All data is sourced from the 高德地图 (Amap) API. The server itself does not store any data; it only passes requests and responses.
Are there any limits on route planning distances?
The cycling route tool supports up to 500 km, and the walking route tool supports routes of 100 km or less.
