# amap-maps-mcp

高德地图 Web Service API 的 MCP Server。

相比[官方包](https://www.npmjs.com/package/@amap/amap-maps-mcp-server)的主要改进：

- 路径规划全部使用**路径规划 2.0（v5 接口）**
- 驾车规划支持完整参数：`strategy`（16 种算路策略）、`waypoints`（途经点）、`plate`（车牌限行规避）、`avoidpolygons`（避让区域）、`show_fields` 等
- 公交规划支持：`strategy`、`nightflag`、`date`/`time` 等
- POI 搜索支持分页、`types`、`citylimit` 参数（官方包的 `types` 参数实际无效）

## 工具列表

| 工具 | 说明 |
|------|------|
| `maps_geo` | 地理编码（地址 → 坐标） |
| `maps_regeocode` | 逆地理编码（坐标 → 地址） |
| `maps_ip_location` | IP 定位 |
| `maps_weather` | 天气查询 |
| `maps_text_search` | POI 关键词搜索 |
| `maps_around_search` | POI 周边搜索 |
| `maps_search_detail` | POI 详情 |
| `maps_direction_driving` | 驾车路径规划（v5） |
| `maps_direction_walking` | 步行路径规划（v5） |
| `maps_bicycling` | 骑行路径规划（v5） |
| `maps_direction_transit_integrated` | 公共交通路径规划（v5） |
| `maps_distance` | 距离测量 |

## 前置要求

在[高德开放平台](https://console.amap.com/dev/key/app)申请 **Web 服务**类型的 API Key。

## 使用方法

### npx（无需安装）

```json
{
  "mcpServers": {
    "amap": {
      "command": "npx",
      "args": ["-y", "amap-maps-mcp"],
      "env": {
        "AMAP_MAPS_API_KEY": "你的APIKey"
      }
    }
  }
}
```

### 全局安装

```bash
npm install -g amap-maps-mcp
```

```json
{
  "mcpServers": {
    "amap": {
      "command": "amap-maps-mcp",
      "env": {
        "AMAP_MAPS_API_KEY": "你的APIKey"
      }
    }
  }
}
```

## 坐标系说明

高德地图使用 GCJ-02 坐标系。GPS 设备输出的 WGS-84 坐标需要先转换，可使用高德的[坐标转换 API](https://lbs.amap.com/api/webservice/guide/api/convert)。

## License

MIT