Docs MCP 是文档查询服务。它提供文档检索和全文获取，不负责执行地图 API 请求，也不替代提供 POI、路线规划、天气等地图能力的 MCP Server。

百度地图的接口和 SDK 文档分布在多个平台和版本中。开发时经常需要确认：

• 一个需求应该选哪个接口或 SDK 能力

• 参数是否必填、应该传什么类型和格式

• 返回字段、错误码和配额限制分别是什么

• 如何把多个接口或 SDK 能力串成一段可运行的代码

Docs MCP 会从已收录的百度地图开放平台文档中检索相关内容，再把完整文档交给 AI 编程助手。这样，回答有明确的参数表、示例和使用限制可供依据，减少只凭训练记忆回答带来的版本和细节错误。

在客户端的 MCP 设置中新增一个远程服务器：

{
  "mcpServers": {
    "baidu-maps-docs": {
      "url": "https://docs.map.baidu.com/mcp"
    }
  }
}

Cursor、Cline、Cherry Studio、Claude Code 等支持远程 HTTP MCP 的客户端，都可以使用这段配置。保存后，在客户端的 MCP 面板确认 baidu-maps-docs 已连接；如果客户端没有自动刷新，再重新加载 MCP 配置。

不需要学习新的命令。像平时一样向 AI 提问即可，例如：

geocoding 接口怎么调用？给我一个 Python 示例。

JSAPI 怎么给 Marker 添加点击事件？

驾车路线规划返回的 direction 字段是什么意思？

鹰眼一个 service 最多可以创建多少个 entity？

对于明确的 API 或 SDK 名称，助手可以直接获取对应文档；对于需要选型或跨平台的问题，会先检索文档目录，再获取一到多篇完整原文。

服务提供两个工具：

按自然语言检索相关文档，返回 name、title、platform、summary 和命中文档片段 highlights。question 应保留用户问题原文；keywords 用于补充召回。

按文档 name 获取完整原文，包括接口地址、请求参数、响应字段、错误码、代码示例、常见问题和使用限制。一次最多获取 8 篇，通常 1 到 3 篇就够用。
典型调用链是：

用户问题
  -> list_docs：找到相关文档
  -> get_docs：获取完整原文
  -> AI：基于文档回答问题或生成代码

当前服务覆盖以下文档平台和能力：

• WebAPI：地理编码、逆地理编码、地点检索、路线规划、坐标转换、IP 定位、鹰眼轨迹、静态地图、天气、交通态势等

• JSAPI：地图初始化、覆盖物、图层、控件和事件交互等

• Android / iOS / 鸿蒙 / Flutter SDK：类参考、方法、事件回调、参数说明和注意事项

• AI 能力：智能算法、智能定位和 AI MCP Server 相关文档

WebAPI 文档按 OpenAPI 3.0 规范管理，并整理为适合 AI 阅读的 Markdown；JSAPI 和各端 SDK 使用清洗后的官方文档原文。

问题：

地理编码接口的 city 参数是必须的吗？

基于文档的回答应明确说明：city 不是必填参数。当同一个地址名称出现在多个城市时，它可以用来过滤并优先指定目标城市，但最终返回的坐标不一定限制在该城市内。需要更高的解析精度时，应尽量提供完整的结构化地址。

• Docs MCP 返回的是文档内容，最终答案仍由 AI 编程助手理解和组织；涉及生产代码时，请核对返回文档中的接口地址、参数和版本。

• Docs MCP 不执行地理编码、路线规划或天气查询，也不提供 AK。需要直接调用地图能力时，请使用百度地图 MCP Server 或对应的 WebAPI / SDK。

• Docs MCP 接入地址：https://docs.map.baidu.com/mcp

• 百度地图 MCP Server（地图能力服务，不是文档服务）：https://mcp.map.baidu.com/mcp?ak=<你的AK>

• 百度地图 MCP Server GitHub：https://github.com/baidu-maps/mcp