高德地图 (Amap) through MCP
高德 publishes an MCP server with twelve tools; configured, they appear to you as amap__maps_*. No browser, no phone, no screenshots: a question about a place is one or two tool calls.
Is it there?
Look for amap__maps_geo in your tools. If it is not there, say so in one line and give the user the four lines to add to config.toml, then stop. Your tools list is the only place it can be: do not run shell commands or scripts to look for it, and when the user asked for an app on their phone and you have read it there, the answer is complete without this skill:
[[mcp.servers]]
name = "amap"
url = "https://mcp.amap.com/mcp?key={{vault:AMAP_KEY}}" # a free Web 服务 key from console.amap.com
risk = "safe"
and nanomuse vault set AMAP_KEY. Without Node, the hosted URL is the way; with it, command = "npx", args = ["-y", "@amap/amap-maps-mcp-server"], env = { AMAP_MAPS_API_KEY = "{{vault:AMAP_KEY}}" } does the same.
The tools
amap__maps_geo: an address or a landmark (北京南站, 上海市浦东新区世纪大道100号) → coordinates lng,lat; amap__maps_regeocode the other way round. Almost everything else wants coordinates, so this comes first.amap__maps_text_search: places by keyword (咖啡, 汉庭酒店) in a city; amap__maps_around_search, the same within radius metres of a location; amap__maps_search_detail, one place's details by its id (opening hours, rating, phone, address).amap__maps_direction_driving, amap__maps_direction_walking, amap__maps_bicycling: a route between two coordinates with distance, duration and the steps; amap__maps_direction_transit_integrated, bus, metro and train together, and across cities with city and cityd.amap__maps_distance: just the distance and time between points (type 1 = driving, 3 = straight line).amap__maps_weather: today and the next few days for a city name or adcode.
Coordinates are 经度,纬度 (longitude first, GCJ-02). Durations come in seconds and distances in metres: say them as minutes and kilometres.
How to answer
- Resolve both ends first, then one route call per mode the user cares about. When they did not say how they travel, compare transit and driving in one line each and say which you would take at that hour.
- A "what's near" question: geocode the centre, one
around_search, then give three places at most with what makes each worth it (rating, distance, open now), not the whole list.
- Travel time is an estimate for now; for a departure later or tomorrow say so, and for a real day-of-travel plan add slack.
- Weather goes into plans the user is making (an outdoor day, a trip) without being asked when it changes the plan (rain on the day of the hike).
With the other hands
- 高德 + 12306: the route to the station (this skill) and the train itself (the
train-tickets skill on the phone) make one plan: leave home at 07:10, G1 at 08:00.
- 高德 + 飞书: a route or an address the user wants to share goes to a colleague with the
feishu skill; a meeting's location is checked before the event is created.
- 高德 + the workspace: a day's itinerary with places, times and the routes between them is a page in
trips/, written with the trip-plan skill; the coordinates and distances come from here.
Finish
A few lines: where, how far, how long, by what, and the weather when it matters. Save nothing unless asked. remember the user's home and workplace once they name them, so that the next "how long to get to …" needs no question.
1---2name: amap3description: Places, routes, travel times, distances and weather in China through the 高德地图 (Amap) MCP server. Use when the user asks how far, how long, how to get somewhere (car, transit, bike, foot), what is near a place, or about the weather in a Chinese city.4channel: api5metadata:6 source: https://skillmd.com/skills/nano-muse/amap7 author: nanoMuse8 version: "1"9---1011# 高德地图 (Amap) through MCP1213高德 publishes an MCP server with twelve tools; configured, they appear to you as `amap__maps_*`. No browser, no phone, no screenshots: a question about a place is one or two tool calls.1415## Is it there?1617Look for `amap__maps_geo` in your tools. If it is not there, say so in one line and give the user the four lines to add to `config.toml`, then stop. Your tools list is the only place it can be: do not run shell commands or scripts to look for it, and when the user asked for an app on their phone and you have read it there, the answer is complete without this skill:1819```toml20[[mcp.servers]]21name = "amap"22url = "https://mcp.amap.com/mcp?key={{vault:AMAP_KEY}}" # a free Web 服务 key from console.amap.com23risk = "safe"24```2526and `nanomuse vault set AMAP_KEY`. Without Node, the hosted URL is the way; with it, `command = "npx"`, `args = ["-y", "@amap/amap-maps-mcp-server"]`, `env = { AMAP_MAPS_API_KEY = "{{vault:AMAP_KEY}}" }` does the same.2728## The tools2930- `amap__maps_geo`: an address or a landmark (`北京南站`, `上海市浦东新区世纪大道100号`) → coordinates `lng,lat`; `amap__maps_regeocode` the other way round. Almost everything else wants coordinates, so this comes first.31- `amap__maps_text_search`: places by keyword (`咖啡`, `汉庭酒店`) in a `city`; `amap__maps_around_search`, the same within `radius` metres of a `location`; `amap__maps_search_detail`, one place's details by its `id` (opening hours, rating, phone, address).32- `amap__maps_direction_driving`, `amap__maps_direction_walking`, `amap__maps_bicycling`: a route between two coordinates with distance, duration and the steps; `amap__maps_direction_transit_integrated`, bus, metro and train together, and across cities with `city` and `cityd`.33- `amap__maps_distance`: just the distance and time between points (`type` 1 = driving, 3 = straight line).34- `amap__maps_weather`: today and the next few days for a `city` name or adcode.3536Coordinates are `经度,纬度` (longitude first, GCJ-02). Durations come in seconds and distances in metres: say them as minutes and kilometres.3738## How to answer3940- Resolve both ends first, then one route call per mode the user cares about. When they did not say how they travel, compare transit and driving in one line each and say which you would take at that hour.41- A "what's near" question: geocode the centre, one `around_search`, then give three places at most with what makes each worth it (rating, distance, open now), not the whole list.42- Travel time is an estimate for now; for a departure later or tomorrow say so, and for a real day-of-travel plan add slack.43- Weather goes into plans the user is making (an outdoor day, a trip) without being asked when it changes the plan (rain on the day of the hike).4445## With the other hands4647- 高德 + 12306: the route to the station (this skill) and the train itself (the `train-tickets` skill on the phone) make one plan: leave home at 07:10, G1 at 08:00.48- 高德 + 飞书: a route or an address the user wants to share goes to a colleague with the `feishu` skill; a meeting's location is checked before the event is created.49- 高德 + the workspace: a day's itinerary with places, times and the routes between them is a page in `trips/`, written with the `trip-plan` skill; the coordinates and distances come from here.5051## Finish5253A few lines: where, how far, how long, by what, and the weather when it matters. Save nothing unless asked. `remember` the user's home and workplace once they name them, so that the next "how long to get to …" needs no question.
