字节笔记本
2026年8月29日
高德和百度地图官方 MCP:给大模型接上路况和周边
大模型接地图,以前多半是自己拼 HTTP、啃一堆签名和坐标系。现在高德和百度都给出了官方 MCP Server:在 Cursor、Claude Desktop 一类客户端里配好 Key,就能用自然语言查周边、算路、看天气和路况。下面按「怎么申请 Key、怎么配 Streamable HTTP / 本地进程、能干什么、怎么验、怎么选」写一遍可复现的双厂商接入。
官方入口:高德 MCP Server 概述、快速接入;百度 baidu-maps/mcp(MIT)、LBS FAQ。
地图 MCP 是什么
MCP(Model Context Protocol)把「工具」交给大模型客户端。地图 MCP 暴露的是地理服务:地理编码、逆地理、POI 搜索、路径规划、天气、IP 定位、路况等。模型不再自己拼 REST,而是按工具 schema 调服务端,再把结构化结果写进对话。
两家都支持:
- Streamable HTTP(推荐):客户端只配一个带 Key 的 URL,无本地进程。
- 本地 stdio:用
npx/uvx拉官方包,Key 走环境变量。
坐标系要注意:百度侧工具默认 bd09ll;高德常用 GCJ-02。跨厂商比坐标前先确认系别,避免「差几百米」。
申请 Key
高德
- 打开 高德开放平台控制台 创建应用。
- 申请 Web 服务 Key(MCP 走服务端能力,按控制台说明勾选对应服务)。
- 记下 Key,后面填进 URL 或
AMAP_MAPS_API_KEY。
文档与配额以控制台和 快速接入 为准。
百度
- 打开 百度地图开放平台密钥控制台 创建应用并申请 AK。
- 按文档开通 MCP / Web 服务相关权限。
- 记下 AK,后面填进 URL 或
BAIDU_MAPS_API_KEY/BAIDU_MAP_API_KEY(本地包名不同,变量名略有差异,见下)。
仓库说明见 baidu-maps/mcp。
高德:Streamable HTTP 与本地配置
Streamable HTTP(推荐)
在 Cursor / Claude Desktop 的 MCP 配置里加入:
{
"mcpServers": {
"amap-maps-streamableHTTP": {
"url": "https://mcp.amap.com/mcp?key=你的高德Key"
}
}
}把 你的高德Key 换成真实 Key。重启客户端后应能看到高德相关工具。
本地 npx
{
"mcpServers": {
"amap-maps": {
"command": "npx",
"args": ["-y", "@amap/amap-maps-mcp-server"],
"env": {
"AMAP_MAPS_API_KEY": "你的高德Key"
}
}
}
}需要本机 Node 与外网拉包。适合要离线调试包版本、或公司策略不允许直连托管 URL 的场景。
高德能力概览
常见能力包括:地理编码 / 逆地理、IP 定位、天气、骑行 / 步行 / 驾车 / 公交路径规划、距离测量、关键词 / 周边 / 详情 POI 搜索。升级后还可拿到地图、导航、打车等深链(以官网当前说明为准)。
百度:Streamable HTTP、SSE 与本地配置
Streamable HTTP
{
"mcpServers": {
"baidu-maps": {
"url": "https://mcp.map.baidu.com/mcp?ak=你的百度AK"
}
}
}SSE(兼容旧客户端)
若客户端只认 SSE 传输,可用:
https://mcp.map.baidu.com/sse?ak=你的百度AK
新客户端优先 Streamable HTTP。
本地 uvx
{
"mcpServers": {
"baidu-maps": {
"command": "uvx",
"args": ["mcp-server-baidu-maps"],
"env": {
"BAIDU_MAPS_API_KEY": "你的百度AK"
}
}
}
}需已安装 uv。
本地 npx
{
"mcpServers": {
"baidu-maps": {
"command": "npx",
"args": ["-y", "@baidumap/mcp-server-baidu-map"],
"env": {
"BAIDU_MAP_API_KEY": "你的百度AK"
}
}
}
}注意:uvx 包用 BAIDU_MAPS_API_KEY,npx 包用 BAIDU_MAP_API_KEY,少一个 S,配错会鉴权失败。
百度工具列表
官方暴露的工具大致包括:
| 工具 | 用途 |
|---|---|
map_geocode / map_reverse_geocode | 地址 ↔ 坐标 |
map_search_places / map_place_details | POI 搜索与详情 |
map_directions / map_directions_matrix | 路径规划与批量矩阵 |
map_weather | 天气 |
map_ip_location | IP 定位 |
map_road_traffic | 路况 |
map_poi_extract | 从文本抽 POI(进阶) |
坐标默认 bd09ll。路况与矩阵类能力是很多「只接了地理编码」方案里缺的一块。
怎么验证接好了
- 配置保存后完全重启 MCP 客户端(Cursor 可重载窗口)。
- 在工具面板确认出现
amap-*或map_*一类工具,而不是空列表。 - 用自然语言试三条(把地名换成你城市):
- 「把『北京市朝阳区望京 SOHO』转成坐标。」
- 「查这个点附近 1 公里的咖啡店,列出名称和距离。」
- 「从望京 SOHO 到国贸,给出驾车路线和预计时间;若有路况一并说明。」
- 若报 Key / AK 无效:回控制台核对权限与配额,确认 URL 查询参数或环境变量名与上文一致。
- 若工具在但结果偏位:检查是否混用了 GCJ-02 与 bd09ll。
什么时候选高德、什么时候选百度
| 维度 | 更偏向高德 | 更偏向百度 |
|---|---|---|
| 接入形态 | 托管 Streamable HTTP + npm 本地包文档清晰 | HTTP / SSE 双通道, uvx / npx |
| 能力偏重 | 多出行方式算路、搜索、天气; 升级后有地图/导航/打车深链 | 路况 map_road_traffic、方向矩阵、文本抽 POI |
| 坐标系 | 国内常见 GCJ-02 生态 | bd09ll, 需和前端 SDK 对齐 |
| 已有资产 | 团队已有高德 Web 服务 Key | 团队已有百度 LBS AK |
实践建议:
- 先上一家: Streamable HTTP + 三条验证话术跑通, 再考虑双挂。
- 双挂时: 给两个 server 起不同名字, 提示词里写清用哪家、坐标用哪套。
- 只要路况或矩阵: 优先试百度工具集。
- 要导航/打车深链或已有高德 Key: 优先高德, 并看控制台是否开了对应升级能力。
小结
高德和百度的官方地图 MCP, 把地理编码、周边、算路、天气以及百度侧路况等收成标准工具, Key 配进 URL 或环境变量即可在 Cursor / Claude 里用。推荐先走 Streamable HTTP, 本地 npx/uvx 作备选; 验证时用编码 → 周边 → 算路/路况三条链路; 选型看已有 Key、坐标系和是否需要路况/深链。完整说明以两边官网与 GitHub 为准, Key 不要写进仓库, 用客户端密钥或本地 env。