百度地图MCP服务器

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

location-services

928 查看 · 2026-07-07 更新

简介

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

简介

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

中文| English


stars python MIT License pypi npm


🚀 简介

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

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

主要特性:

  • 全面支持MCP协议:无缝集成任何符合MCP标准的代理、LLM或平台。
  • 丰富的LBS功能:地理编码、反向地理编码、POI搜索、路线规划(驾车、步行、骑行、公交)、天气、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从坐标获取地址、区域和POI信息。
map_search_places按关键字、类型、区域或半径搜索POI。
map_place_details通过其唯一ID获取POI的详细信息。
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_directionsmap_weather 构建一个能够规划最优观光路线、检查天气并推荐POI的代理。

  • 批量路线矩阵:
    使用map_directions_matrix 计算多个路线和持续时间,用于物流或配送优化。

  • 文本到POI提取:
    使用map_poi_extract 从用户输入或旅行笔记中提取POI(需要高级权限)。

  • 实时交通与天气感知导航:
    结合map_road_trafficmap_weather 提供动态、上下文感知的旅行建议。

  • 与Claude, Qianfan, AppBuilder集成:
    将百度地图MCP服务器无缝连接到LLMs和代理框架,进行自然语言地理空间推理。

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


⛰️ 高级教程

👩‍👩‍👧‍👦 贡献者

🌟 星标历史

星标历史图表

📄 许可证

MIT © baidu-maps

工具列表

  • map_geocode: 地理编码服务: 将地址解析为对应的位置坐标.地址结构越完整, 地址内容越准确, 解析的坐标精度越高.

  • map_reverse_geocode: 逆地理编码服务: 根据纬经度坐标, 获取对应位置的地址描述, 所在行政区划, 道路以及相关POI等信息

  • map_search_places: 地点检索服务: 支持检索城市内的地点信息(最小到city级别), 也可支持圆形区域内的周边地点信息检索. 城市内检索: 检索某一城市内(目前最细到城市级别)的地点信息. 周边检索: 设置圆心和半径, 检索圆形区域内的地点信息(常用于周边检索场景).

  • map_place_details: 地点详情检索服务: 地点详情检索针对指定POI, 检索其相关的详情信息. 通过地点检索服务获取POI uid.使用地点详情检索功能, 传入uid, 即可检索POI详情信息, 如评分、营业时间等(不同类型POI对应不同类别详情数据).

  • map_directions_matrix: 批量算路服务: 根据起点和终点坐标计算路线规划距离和行驶时间. 批量算路目前支持驾车、骑行、步行. 步行时任意起终点之间的距离不得超过200KM, 超过此限制会返回参数错误. 驾车批量算路一次最多计算100条路线, 起终点个数之积不能超过100.

  • map_directions: 路线规划服务: 根据起终点位置名称纬经度坐标规划出行路线. 驾车路线规划: 根据起终点位置名称纬经度坐标规划驾车出行路线. 骑行路线规划: 根据起终点位置名称纬经度坐标规划骑行出行路线. 步行路线规划: 根据起终点位置名称纬经度坐标规划步行出行路线. 公交路线规划: 根据起终点位置名称纬经度坐标规划公共交通出行路线.

  • map_weather: 天气查询服务: 通过行政区划或是经纬度坐标查询实时天气信息及未来5天天气预报.

  • map_ip_location: IP定位服务: 通过所给IP获取具体位置信息和城市名称, 可用于定位IP或用户当前位置.

  • map_road_traffic: 实时路况查询服务: 查询实时交通拥堵情况, 可通过指定道路名和区域形状(矩形, 多边形, 圆形)进行实时路况查询. 道路实时路况查询: 查询具体道路的实时拥堵评价和拥堵路段、拥堵距离、拥堵趋势等信息. 矩形区域实时路况查询: 查询指定矩形地理范围的实时拥堵情况和各拥堵路段信息. 多边形区域实时路况查询: 查询指定多边形地理范围的实时拥堵情况和各拥堵路段信息. 圆形区域(周边)实时路况查询: 查询某中心点周边半径范围内的实时拥堵情况和各拥堵路段信息.

  • map_poi_extract: POI智能提取

服务配置

[{'mcpServers': {'baidu-maps': {'args': ['-m', 'mcp_server_baidu_maps'], 'command': 'python', 'env': {'BAIDU_MAPS_API_KEY': '<YOUR_API_KEY>'}}}}, {'mcpServers': {'baidu-map': {'args': ['-y', '@baidumap/mcp-server-baidu-map'], 'command': 'npx', 'env': {'BAIDU_MAP_API_KEY': '<YOUR_API_KEY>'}}}}]

来源