Amap Maps Skill
Call Amap services via Streamable HTTP MCP.
Quick Start
1. Install Dependencies
cd amap-maps
npm install
2. Set Environment Variables
export AMAP_KEY="Your Amap Key"
Get Key: https://lbs.amap.com/api/javascript-api-v2/guide/abc/register
3. Use Command Line Tool
# View all commands
node scripts/amap.js help
# Query weather
node scripts/amap.js weather 北京
# Address to coordinates
node scripts/amap.js geo encode "北京市朝阳区望京 SOHO" 北京
# Coordinates to address
node scripts/amap.js geo decode "116.482384,39.998383"
# Search POI
node scripts/amap.js search text 麦当劳 北京
# Nearby search
node scripts/amap.js search around "116.48,39.99" 餐厅 1000
# Route planning
node scripts/amap.js route driving "116.48,39.99" "116.40,39.91"
node scripts/amap.js route walking "116.48,39.99" "116.40,39.91"
node scripts/amap.js route bicycling "116.48,39.99" "116.40,39.91"
node scripts/amap.js route transit "116.48,39.99" "116.40,39.91" "北京" "北京"
# Distance measurement
node scripts/amap.js distance "116.48,39.99" "116.40,39.91" 1
# IP location
node scripts/amap.js ip-location "114.114.114.114"
# Navigation Schema (generate Amap URI)
node scripts/amap.js navi "116.397428" "39.90923"
# Taxi Schema
node scripts/amap.js taxi "116.397428" "39.90923" "天安门"
Tool List (15 tools)
| Category | Command | Description |
|---|---|---|
| Weather | weather <city> | Query city weather |
| Geocoding | geo encode <address> [city] | Address → Coordinates |
geo decode <coordinates> | Coordinates → Address | |
| Search | search text <keyword> [city] | Keyword search POI |
search around <coordinates> <keyword> [radius] | Nearby search | |
search detail <POI_ID> | POI details | |
| Routes | route driving <origin> <destination> | Driving route planning |
route walking <origin> <destination> | Walking route planning | |
route bicycling <origin> <destination> | Cycling route planning | |
route transit <origin> <destination> <city> <cityd> | Transit route planning | |
| Distance | distance <origin> <destination> [type] | Distance measurement (0=linear, 1=driving, 3=walking) |
| Location | ip-location <IP> | IP location |
| Schema | navi <lon> <lat> | Generate navigation URI |
taxi <lon> <lat> <name> | Generate taxi URI |
Common Workflows
Workflow 1: Search Place → Plan Route
# 1. Search destination
node scripts/amap.js search text 天安门 北京
# 2. Get location (coordinates) from results
# 3. Plan driving route
node scripts/amap.js route driving "116.48,39.99" "116.397428,39.90923"
Workflow 2: Current Location Weather
# 1. Get city via IP location
node scripts/amap.js ip-location "114.114.114.114"
# 2. Query weather for that city
node scripts/amap.js weather 南京
Workflow 3: Nearby Exploration
# 1. Address to coordinates
node scripts/amap.js geo encode "北京市朝阳区望京 SOHO"
# 2. Search nearby restaurants
node scripts/amap.js search around "116.47,39.99" 餐厅 1000
Error Handling
Common Errors
| Error | Cause | Solution |
|---|---|---|
AMAP_KEY not set | Missing environment variable | Run export AMAP_KEY="..." |
Invalid API Key | Key is invalid or expired | Check if Key is correct |
Missing parameters | Missing required parameters | Check command format |
Rate limit exceeded | Request rate limit exceeded | Reduce request frequency |