百度地图 MCP Server

🚀 简介

Baidu Map MCP Server 是一款完全符合 MCP 规范的开源位置服务（LBS）解决方案，为开发者和 AI Agent 提供一整套全面的地理空间 API 和工具。作为中国首家支持 Model Context Protocol（MCP） 的地图服务提供商，Baidu Map MCP Server 打通了大模型（LLM）、AI Agent 与真实世界位置数据和服务之间的连接。

借助 Baidu Map MCP Server，你可以通过标准化、便于开发者使用的 MCP 接口，轻松为应用、大模型和 Agent 提供高级地图、地理编码、POI 搜索、路线规划、天气、交通等功能。

主要特性：

• 全面支持 MCP 协议： 可与任何符合 MCP 规范的 Agent、大模型或平台无缝集成。
• 丰富的 LBS 能力： 支持地理编码、逆地理编码、POI 搜索、路线规划（驾车、步行、骑行、公共交通）、天气、IP 定位、实时路况等功能。
• 跨平台 SDK： 提供官方 Python 和 TypeScript SDK，支持便捷的命令行操作和云端部署。
• 企业级数据： 依托 Baidu Maps 权威且及时更新的地理空间数据。
• 高性能与稳定性： 推荐使用 SSE（Server-Sent Events）接入，以实现低延迟和高可靠性。
• 开源且易扩展： 采用 MIT 许可，易于定制和扩展。

无论你是在构建旅行助手、物流平台、智慧城市解决方案，还是大模型驱动的 Agent，Baidu Map MCP Server 都能提供所需的核心地理空间智能能力和工具。

MCP 服务架构支持：

• 无缝集成 AI：让大模型和 Agent 能够自然地理解和处理位置数据
• 上下文理解：提供丰富的地理空间上下文，助力更智能的决策
• 标准化接口：遵循 MCP 原则，采用一致的 API 设计，便于集成
• 可扩展的实现：适用于各种规模的项目，从小型应用到企业级解决方案

无论你是在构建导航应用、配送服务、智慧城市解决方案，还是为 AI Agent 增强位置感知能力，Baidu Map MCP Server 都能提供成功所需的工具和基础设施。

🛠️ 支持的工具和 API

Baidu Map MCP Server 提供以下符合 MCP 规范的 API（工具）：

工具名称	描述
map_geocode	将地址转换为地理坐标。
map_reverse_geocode	根据坐标获取地址、区域和 POI 信息。
map_search_places	按关键词、类型、区域或半径范围搜索全球 POI。
map_place_details	根据 POI 的唯一 ID 获取详细信息。
map_directions_matrix	批量规划多个起点和终点之间的路线（驾车、步行、骑行）。
map_directions	规划两点之间的路线（驾车、步行、骑行、公共交通）。
map_weather	按区域或坐标查询实时天气和天气预报。
map_ip_location	根据 IP 地址定位城市和坐标。
map_road_traffic	查询道路或区域的实时交通状况。
map_poi_extract*	从自由文本中提取 POI 信息（需要高级权限）。

*部分高级功能需要额外权限。详情请参阅授权。

所有 API 均遵循 MCP 协议，可通过任何符合 MCP 规范的客户端、大模型或 Agent 平台调用。

⚡ 快速开始

1. 获取 API 密钥

在 Baidu Maps Open Platform 注册并创建服务端 API Key（AK）。 请务必启用“MCP（SSE）”服务，以获得最佳性能。

2. Python 集成

安装 SDK：

pip install mcp-server-baidu-maps

作为脚本运行：

python -m mcp_server_baidu_maps

在 MCP 客户端中配置（例如 Claude、Cursor）：

{
  "mcpServers": {
    "baidu-maps": {
      "command": "python",
      "args": ["-m", "mcp_server_baidu_maps"],
      "env": {
        "BAIDU_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

3. Node.js/TypeScript 集成

安装：

npm install @baidumap/mcp-server-baidu-map

在 MCP 客户端中配置：

{
  "mcpServers": {
    "baidu-map": {
      "command": "npx",
      "args": [
        "-y",
        "@baidumap/mcp-server-baidu-map"
      ],
      "env": {
        "BAIDU_MAP_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

4. 推荐：使用 SSE 实现低延迟、稳定访问

请参阅 SSE 快速入门。

5. 更多平台

• Claude/Agent/千帆AppBuilder：有关详细的集成指南和高级配置，请参阅 README_zh.md。

---

🚀 高级使用场景

• 旅行规划助手：
  使用 map_search_places、map_directions 和 map_weather 构建 Agent，以规划最佳观光路线、查询天气并推荐 POI。

• 批量路线矩阵：
  使用 map_directions_matrix 计算多条路线和行程时长，以优化物流或配送。

• 文本转 POI 提取：
  使用 map_poi_extract 从用户输入或旅行笔记中提取 POI（需要高级权限）。

• 实时交通和天气感知导航：
  结合使用 map_road_traffic 和 map_weather，提供动态且结合情境的出行建议。

• 与 Claude、Qianfan、AppBuilder 集成：
  将 Baidu Map MCP Server 无缝连接到大模型和 Agent 框架，实现自然语言地理空间推理。

更多中文文档、配置和示例，请参阅 README_zh.md。

---

⛰️ 高级教程

• 地理编码 API 指南
• POI 搜索 API 指南
• 路线规划 API 指南
• MCP 集成指南
• SDK 开发指南

👩‍👩‍👧‍👦 Contributors

🌟 Star History

📄 License

MIT © baidu-maps