# MCP 高德地图

> 高德地图服务，提供地点搜索、路径规划、天气查询、地理编码等功能。支持IP定位、POI搜索、路线规划、坐标转换等常用地图服务。

- Skill: `caoronglin/mcp` (Agent Skill)
- Install (CLI): `npx skillmds@latest add caoronglin/mcp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/caoronglin/mcp/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: caoronglin (https://skillmd.com/u/caoronglin)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/caoronglin/mcp

---


# 高德地图 MCP 技能

## 功能说明

高德地图 MCP Server 提供全面的地图服务：

- 📍 **IP定位**：根据IP地址定位
- 🔍 **POI搜索**：搜索周边兴趣点
- 🗺️ **地理编码**：地址与坐标相互转换
- 🚗 **路线规划**：驾车、步行、公交路线
- 🌤️ **天气查询**：指定地点的天气信息
- 🔄 **坐标转换**：不同坐标系之间的转换

## 工具列表

### 1. locate_ip - IP定位

**功能**：根据IP地址获取地理位置

**参数说明**：

| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| ip | string | ❌ | IP地址，为空则使用请求方IP |

**返回信息**：
- 省份、城市
- 经纬度坐标
- ISP信息

**使用示例**：
```json
{
  "ip": "114.247.50.2"
}
```

### 2. search_poi - POI搜索

**功能**：搜索指定类型的兴趣点

**参数**：

| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| keywords | string | ✅ | 搜索关键词 |
| location | string | ❌ | 中心点坐标 |
| radius | integer | ❌ | 搜索半径（米） |
| types | string | ❌ | POI类型 |
| offset | integer | ❌ | 每页记录数 |

**POI类型代码**：
- 餐饮服务：050000
- 酒店住宿：060000
- 购物服务：060100
- 医疗保健：090000
- 交通设施：150000

### 3. geocode - 地理编码

**功能**：将地址转换为经纬度坐标

**参数**：
- `address`: 结构化地址

**返回**：
- 经纬度坐标
- 精确度等级
- 匹配的地址

### 4. regeocode - 逆地理编码

**功能**：将坐标转换为地址信息

**参数**：
- `location`: 经纬度坐标
- `radius`: 搜索半径（米）

**返回**：
- 省市区信息
- 街道门牌号
- 周边POI

### 5. get_driving_route - 驾车路线规划

**功能**：规划驾车路线

**参数**：

| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| origin | string | ✅ | 起点坐标 |
| destination | string | ✅ | 终点坐标 |
| strategy | integer | ❌ | 路径策略 |

**策略代码**：
- 0：速度优先
- 1：费用优先
- 2：距离优先
- 4：躲避拥堵

**返回信息**：
- 总距离、总时间
- 分段路线详情
- 路况信息

### 6. get_walking_route - 步行路线规划

**功能**：规划步行路线

**参数**：
- `origin`: 起点坐标
- `destination`: 终点坐标

### 7. get_transit_route - 公交路线规划

**功能**：规划公共交通路线

**参数**：
- `origin`: 起点
- `destination`: 终点
- `city`: 城市名称

## 配置方式

### 获取API Key
1. 访问高德开放平台：https://lbs.amap.com
2. 注册并创建应用
3. 获取Web服务API Key

### MCP 配置
```json
{
  "mcpServers": {
    "amap": {
      "command": "uvx",
      "args": ["amap-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### SSE 传输模式
```bash
export AMAP_MAPS_API_KEY=your_api_key
uvx amap-mcp-server --transport sse --port 8000
```

## 使用场景

### 1. 查找周边地点
```
用户：帮我找附近的餐厅
助手：[调用 search_poi，类型=餐饮]
```

### 2. 路线规划
```
用户：从A到B怎么走？
助手：[调用 get_driving_route]
```

### 3. 地址解析
```
用户：这个地址的经纬度是多少？
助手：[调用 geocode]
```

### 4. 定位服务
```
用户：我现在在哪里？
助手：[调用 locate_ip]
```

## 坐标格式说明

### 支持的坐标系
- GCJ-02（国测局坐标，高德使用）
- WGS-84（GPS原始坐标）
- BD-09（百度坐标）

### 坐标格式
```
经度,纬度
例如：116.397428,39.90923
```

## 触发时机
- 需要查询地点信息
- 路线规划导航
- 地址与坐标转换
- 周边设施搜索
- 地理位置相关查询

## 最佳实践

### 1. POI搜索优化
```python
# 指定搜索范围
search_poi(
    keywords="餐厅",
    location="116.397,39.909",  # 中心点
    radius=1000  # 1公里范围
)

# 按类型筛选
search_poi(
    types="050000",  # 餐饮服务
    location="116.397,39.909"
)
```

### 2. 路线规划策略
```
日常通勤：躲避拥堵（strategy=4）
长途出行：速度优先（strategy=0）
省钱路线：费用优先（strategy=1）
```

### 3. 坐标精度
- 一般查询：保留6位小数
- 精确定位：保留8位小数

## 注意事项

⚠️ **重要提示**：
1. API Key 需要妥善保管
2. 免费版有调用次数限制
3. 国内服务使用GCJ-02坐标系
4. 坐标转换时注意坐标系差异

## API 配额说明

| 服务类型 | 个人开发者 | 企业版 |
|---------|-----------|--------|
| POI搜索 | 5000次/天 | 50000次/天 |
| 路线规划 | 5000次/天 | 50000次/天 |
| 地理编码 | 5000次/天 | 50000次/天 |

## 与其他工具配合

### 出行规划
```
amap（路线规划）→ 12306（火车票）→ 天气查询
```

### 位置服务
```
amap（定位）→ 搜索周边 → 路线导航
```

## 官方资源

- **官网**: https://lbs.amap.com
- **API文档**: https://lbs.amap.com/api/webservice/summary
- **控制台**: https://console.amap.com
- **GitHub**: https://github.com/sugarforever/amap-mcp-server

## 常见问题

### Q: 为什么坐标有偏差？
**A**: 高德使用GCJ-02坐标系，与GPS原始坐标(WGS-84)有偏差

### Q: POI搜索结果太少？
**A**: 尝试：
- 放宽搜索范围
- 使用更通用的关键词
- 指定正确的类型代码

### Q: 如何提高配额？
**A**: 完成企业认证或购买增值服务

---
*更新时间: 2026-03-08*
*版本: 1.0*