百度地图MCP服务器是一个完全符合MCP协议的开源位置服务(LBS)解决方案,为开发者和AI代理提供了全面的地理空间API和工具。它支持完整的MCP协议、丰富的LBS功能、跨平台SDK等。
928 查看 · 2026-07-07 更新
简介
百度地图MCP服务器是一个完全符合MCP协议的开源位置服务(LBS)解决方案,为开发者和AI代理提供了全面的地理空间API和工具。它支持完整的MCP协议、丰富的LBS功能、跨平台SDK等。
简介
百度地图MCP服务器是一个完全符合MCP协议的开源位置服务(LBS)解决方案,为开发者和AI代理提供了全面的地理空间API和工具。它支持完整的MCP协议、丰富的LBS功能、跨平台SDK等。
🚀 简介
百度地图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_directions和map_weather构建一个能够规划最优观光路线、检查天气并推荐POI的代理。 -
批量路线矩阵:
使用map_directions_matrix计算多个路线和持续时间,用于物流或配送优化。 -
文本到POI提取:
使用map_poi_extract从用户输入或旅行笔记中提取POI(需要高级权限)。 -
实时交通与天气感知导航:
结合map_road_traffic和map_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>'}}}}]
来源
- 来源:github
- 链接:https://github.com/baidu-maps/mcp