amap-maps

# Amap Maps Skill

Call Amap services via Streamable HTTP MCP.

## Quick Start

### 1. Install Dependencies

```bash
cd amap-maps
npm install
```

### 2. Set Environment Variables

```bash
export AMAP_KEY="Your Amap Key"
```

Get Key: https://lbs.amap.com/api/javascript-api-v2/guide/abc/register

### 3. Use Command Line Tool

```bash
# 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...