百

百度地图MCP服务器

aifeng666/baidu-maps-local

1 Stars 531 次浏览更新于 2026-08-23

百度地图MCP服务器是一个完全符合MCP协议的开源位置服务（LBS）解决方案，为开发者和AI代理提供全面的地理空间API和工具。它支持完整的MCP协议、丰富的LBS功能、跨平台SDK等。

位置服务

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "baidu-map": {
      "args": [
        "-y",
        "@baidumap/mcp-server-baidu-map"
      ],
      "command": "npx",
      "env": {
        "BAIDU_MAP_API_KEY": "\u003cYOUR_API_KEY\u003e"
      }
    },
    "baidu-maps": {
      "args": [
        "-m",
        "mcp_server_baidu_maps"
      ],
      "command": "python",
      "env": {
        "BAIDU_MAPS_API_KEY": "\u003cYOUR_API_KEY\u003e"
      }
    }
  }
}

该服务需要配置环境变量：BAIDU_MAPS_API_KEY、BAIDU_MAP_API_KEY

服务介绍

中文| English

🚀 简介

百度地图MCP服务器是一个完全符合MCP协议的开源位置服务（LBS）解决方案，为开发者和AI代理提供了一整套地理空间API和工具。作为中国首个支持模型上下文协议 (MCP) 的地图服务提供商，百度地图MCP服务器在大型语言模型（LLMs）、AI代理与现实世界的位置数据和服务之间架起了桥梁。

通过百度地图MCP服务器，您可以轻松地为您的应用程序、LLMs和代理提供高级地图、地理编码、兴趣点搜索、路线规划、天气、交通等服务——所有这些都通过标准化的、对开发者友好的MCP接口实现。

主要功能：

全面支持MCP协议：无缝集成任何符合MCP标准的代理、LLM或平台。
丰富的LBS功能：地理编码、反向地理编码、兴趣点搜索、路线规划（驾车、步行、骑行、公交）、天气、IP定位、实时交通等。
跨平台SDK：官方Python和TypeScript SDK，易于使用的CLI和云部署。
企业级数据：由百度地图权威且最新的地理空间数据驱动。
高性能和稳定性：推荐使用SSE（服务器发送事件）访问以实现低延迟和高可靠性。
开源且可扩展：采用MIT许可，易于定制和扩展。

无论您是在构建旅行助手、物流平台、智慧城市解决方案还是基于LLM的代理，百度地图MCP服务器都能为您提供所需的地理空间智能和工具。

MCP服务器架构支持：

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

无论您是在构建导航应用、配送服务、智慧城市解决方案，还是增强具有位置感知能力的AI代理，百度地图MCP服务器都能为您提供成功所需的工具和基础设施。

🛠️ 支持的工具和API

百度地图MCP服务器提供了以下符合MCP标准的API（工具）：

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

*某些高级功能需要额外的权限。详情请参见授权。

所有 API 遵循 MCP 协议，可以从任何符合 MCP 标准的客户端、LLM 或代理平台调用。

⚡ 快速开始

1. 获取您的 API 密钥

在百度地图开放平台注册并创建一个服务器端 API 密钥 (AK)。
确保启用“MCP (SSE)”服务以获得最佳性能。

2. Python 集成

安装 SDK：
bash
pip install mcp-server-baidu-maps

作为脚本运行：
bash
python -m mcp_server_baidu_maps

在您的 MCP 客户端（例如 Claude, Cursor）中配置：
json
{
"mcpServers": {
"baidu-maps": {
"command": "python",
"args": ["-m", "mcp_server_baidu_maps"],
"env": {
"BAIDU_MAPS_API_KEY": "<YOUR_API_KEY>"
}
}
}
}

3. Node.js/TypeScript 集成

安装：
bash
npm install @baidumap/mcp-server-baidu-map

在您的 MCP 客户端中配置：
json
{
"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 构建一个可以规划最优观光路线、检查天气并推荐 POI 的代理。
批量路线矩阵:
使用 map_directions_matrix 计算多个路线和持续时间，用于物流或配送优化。
文本到POI提取:
使用 map_poi_extract 从用户输入或旅行笔记中提取 POI（需要高级权限）。
实时交通与天气感知导航:
结合 map_road_traffic 和 map_weather 提供动态、上下文感知的旅行建议。
与 Claude, Qianfan, AppBuilder 的集成:
将百度地图 MCP 服务器无缝连接到 LLM 和代理框架，实现自然语言地理空间推理。

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

⛰️ 高级教程

👩‍👩‍👧‍👦 贡献者

🌟 Star 历史

📄 许可证

查看源码项目主页