百度地图

Baidu Map MCP Server 是一个完全符合 MCP 协议的开源基于位置的服务解决方案,为开发者和 AI 代理提供全面的地理空间 API 和工具。

  • by baidu-maps
  • Python
  • 混合部署
  • 10万 星标
  • 更新于
在 GitHub 查看 baidu-maps/mcp

使用说明

中文|英语



🚀 引言

百度地图MCP服务器 是一个完全符合MCP标准的开源基于位置的服务(LBS)解决方案,为开发人员和人工智能代理提供了一套全面的地理空间API和工具。作为中国第一家支持 模型上下文协议(MCP)百度地图MCP服务器弥合了大型语言模型(LLM)、人工智能代理和现实世界位置数据和服务之间的差距。

借助百度地图MCP服务器,您可以轻松地为您的应用程序、LLM和代理提供高级地图、地理编码、POI搜索、路线规划、天气、交通等功能,所有这些都可以通过标准化、开发人员友好的MCP界面来实现。

主要特点:

  • 完全支持MCP协议: 与任何符合MCP标准的代理、LLM或平台无缝集成。
  • 丰富的LBS功能: 地理编码、反向地理编码、POI搜索、路线规划(驾驶、步行、骑自行车、公交)、天气、IP位置、实时交通等。
  • 跨平台SDK: 官方Python和TypeScript SDK,易于CLI和云部署。
  • 企业级数据: 由百度地图权威、最新的地理空间数据提供支持。
  • 高性能和稳定性: 建议使用SSE(服务器发送事件)访问,以实现低延迟和高可靠性。
  • 开源和可扩展: MIT授权,易于定制和扩展。

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

MCP服务器架构支持:

  • 无缝AI集成:允许LLM和代理自然地理解和处理位置数据
  • 情境理解:为更智能的决策提供丰富的地理空间背景
  • 标准化接口:遵循MCP原则的一致API设计,便于集成
  • 可扩展的实施:适用于任何规模的项目,从小型应用程序到企业解决方案

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

🛠️ 支持的工具和API

百度地图MCP服务器提供以下符合MCP的API(工具):

工具名称 描述
map_geocode 将地址转换为地理坐标。
map_reverse_geocode 从坐标中获取地址、地区和POI信息。
map_search_places 按关键字、类型、地区或半径搜索全局POI。
map_place_details 通过POI的唯一ID获取POI的详细信息
map_directions_matrix 为多个起点/目的地(驾驶、步行、骑自行车)进行批量路线规划。
map_directions 规划两点之间的路线(开车、步行、骑自行车、公交)。
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:

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.更多平台

  • 克劳德/代理人/千帆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 有关更详细的中文文档、配置和示例。


⛰️ 高级教程

👩‍👩‍👧‍👦 贡献者

🌟 明星历史

📄 许可证

麻省理工学院 ©百度地图