mcp

name	MCP 高德地图
description	高德地图服务，提供地点搜索、路径规划、天气查询、地理编码等功能。支持IP定位、POI搜索、路线规划、坐标转换等常用地图服务。
triggers	["地图","位置","导航","路线规划","POI","地理编码","高德"]
mcp	{"command":"uvx","args":["amap-mcp-server"],"env":{"AMAP_MAPS_API_KEY":"your_api_key"}}

高德地图 MCP 技能

功能说明

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

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

工具列表

1. locate_ip - IP定位

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

参数说明：

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

返回信息：

• 省份、城市
• 经纬度坐标
• ISP信息

使用示例：

{
  "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 配置

{
  "mcpServers": {
    "amap": {
      "command": "uvx",
      "args": ["amap-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "your_api_key_here"
      }
    }
  }
}

SSE 传输模式

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搜索优化

# 指定搜索范围
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