目录
AI笔记系列(四)—— 高德Mcp Server:打通AI与地图服务的桥梁
高德地图开放平台通用级 SSE 协议 MCP 服务解决方案
产品架构图
效果:
接入步骤
接入高德地图 MCP Server 通常涉及以下步骤,具体实现可能因使用的客户端和具体 Server 实现而异(以下以社区提供的天气查询 MCP Server 为例
基础接入流程
理解 MCP 协议: MCP (Model Context Protocol) 是一个开放协议,允许 AI 模型安全地连接到外部数据源和工具
3 。获取高德地图 API 密钥:
- 注册成为高德开放平台开发者:访问高德开放平台注册账号
- 创建新应用:在控制台中选择”新建应用”,类型选择”出行”
- 申请 API Key:在应用中选择”新增 Key”,服务平台选择”Web服务”
3
选择接入方式:高德地图 MCP 提供两种接入方式
3 :- SSE 方式:无需部署本地服务,通过简单配置即可使用,但连接可能不稳定
- npm 方式:需要安装 Node.js 环境,推荐使用 v22.14.0 版本,连接更稳定
配置 MCP Server:
- SSE 方式配置:
1
2
3
4
5
6
7{
"mcpServers": {
"amap-amap-sse": {
"url": "https://mcp.amap.com/sse?key=您在高德官网上申请的key"
}
}
} - npm 方式配置(Windows 环境):
1
2
3
4
5
6
7
8
9
10
11
12
13{
"amap-maps": {
"command": "cmd /c",
"args": [
"npx",
"-y",
"@amap/amap-maps-mcp-server"
],
"env": {
"AMAP_MAPS_API_KEY": "你的key"
}
}
} - npm 方式配置(Mac/Linux 环境):
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16{
"mcpServers": {
"amap-weather-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
"run",
"weather.py"
],
"env": {
"AMAP_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}
- SSE 方式配置:
启动 MCP Server: 在服务器环境中运行 MCP Server 程序,确认服务状态正常
3 。连接 MCP 客户端: 在支持 MCP 的客户端(如 Claude Desktop、Cherry Studio、Cursor 或自定义脚本)中配置并连接到你的 MCP Server
1 。- 例如,在 Claude Desktop 中,需要修改
claude_desktop_config.json
文件,添加服务器配置 - 在 Cursor 中,通过设置界面添加 MCP 配置
- 例如,在 Claude Desktop 中,需要修改
调用 Server 工具: 通过客户端调用 MCP Server 提供的工具函数,获取所需的高德地图服务数据
1 。(可选)与高德地图 APP 集成: 利用 MCP Server 的能力,可以将 AI 生成的内容(如旅行攻略)与高德地图 APP 打通,实现一键生成专属地图、导航等功能
1 。
高德地图 MCP 核心功能
高德地图 MCP Server 现已覆盖12大核心服务接口
位置确定
- 地理编码:将详细的结构化地址转换为经纬度坐标
- 逆地理编码:将经纬度坐标转换为行政区划地址信息
- IP定位:根据用户输入的 IP 地址,定位 IP 的所在位置
路径规划
- 骑行路径规划:规划骑行通勤方案,最大支持 500km 的骑行路线
- 步行路径规划:规划 100km 以内的步行通勤方案
- 驾车路径规划:规划小客车、轿车通勤出行的方案
- 公交路径规划:规划综合各类公共交通方式的通勤方案
数据查询与分析
- 关键词搜索:根据关键词搜索相关的 POI 地点信息
- 周边搜索:搜索指定半径范围内的 POI 地点信息
- 详情搜索:查询 POI 的详细信息
- 距离测量:测量两个经纬度坐标之间的距离
天气服务
- 天气查询:根据城市名称或标准 adcode 查询指定城市的天气
应用场景示例
- 智能出行:为用户提供基于位置的智能出行计划
- 旅游规划:为用户提供最佳旅游路线以及浏览景点的时间顺序等
- 周边服务:为用户提供周边服务推荐
- 天气服务:为用户提供基于位置信息的天气信息
请参考具体的 MCP Server 文档和高德开放平台文档获取详细的接入指南。