ByteNoteByteNote

字节笔记本

2026年8月29日

高德和百度地图官方 MCP:给大模型接上路况和周边

API中转
¥120

大模型接地图,以前多半是自己拼 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

高德

  1. 打开 高德开放平台控制台 创建应用。
  2. 申请 Web 服务 Key(MCP 走服务端能力,按控制台说明勾选对应服务)。
  3. 记下 Key,后面填进 URL 或 AMAP_MAPS_API_KEY

文档与配额以控制台和 快速接入 为准。

百度

  1. 打开 百度地图开放平台密钥控制台 创建应用并申请 AK。
  2. 按文档开通 MCP / Web 服务相关权限。
  3. 记下 AK,后面填进 URL 或 BAIDU_MAPS_API_KEY / BAIDU_MAP_API_KEY(本地包名不同,变量名略有差异,见下)。

仓库说明见 baidu-maps/mcp

高德:Streamable HTTP 与本地配置

Streamable HTTP(推荐)

在 Cursor / Claude Desktop 的 MCP 配置里加入:

json
{
  "mcpServers": {
    "amap-maps-streamableHTTP": {
      "url": "https://mcp.amap.com/mcp?key=你的高德Key"
    }
  }
}

你的高德Key 换成真实 Key。重启客户端后应能看到高德相关工具。

本地 npx

json
{
  "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

json
{
  "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

json
{
  "mcpServers": {
    "baidu-maps": {
      "command": "uvx",
      "args": ["mcp-server-baidu-maps"],
      "env": {
        "BAIDU_MAPS_API_KEY": "你的百度AK"
      }
    }
  }
}

需已安装 uv

本地 npx

json
{
  "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_detailsPOI 搜索与详情
map_directions / map_directions_matrix路径规划与批量矩阵
map_weather天气
map_ip_locationIP 定位
map_road_traffic路况
map_poi_extract从文本抽 POI(进阶)

坐标默认 bd09ll。路况与矩阵类能力是很多「只接了地理编码」方案里缺的一块。

怎么验证接好了

  1. 配置保存后完全重启 MCP 客户端(Cursor 可重载窗口)。
  2. 在工具面板确认出现 amap-*map_* 一类工具,而不是空列表。
  3. 用自然语言试三条(把地名换成你城市):
    • 「把『北京市朝阳区望京 SOHO』转成坐标。」
    • 「查这个点附近 1 公里的咖啡店,列出名称和距离。」
    • 「从望京 SOHO 到国贸,给出驾车路线和预计时间;若有路况一并说明。」
  4. 若报 Key / AK 无效:回控制台核对权限与配额,确认 URL 查询参数或环境变量名与上文一致。
  5. 若工具在但结果偏位:检查是否混用了 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。

分享: