百

百度地图MCP服务器

aifeng666/baidu-maps
Hosted
2 Stars 986 次浏览 更新于 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

可用工具 （10 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

map_geocode 1 个参数 需填 1 项

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

必填参数：address

map_reverse_geocode 2 个参数 需填 2 项

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

必填参数：latitude、longitude

map_search_places 5 个参数 需填 1 项

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

必填参数：query

map_place_details 1 个参数 需填 1 项

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

必填参数：uid

map_directions_matrix 3 个参数 需填 2 项

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

必填参数：origins、destinations

map_directions 3 个参数 需填 2 项

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

必填参数：origin、destination

map_weather 2 个参数

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

该工具无需必填参数，直接调用即可

map_ip_location 1 个参数

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

该工具无需必填参数，直接调用即可

map_road_traffic 7 个参数 需填 1 项

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

必填参数：model

map_poi_extract 1 个参数 需填 1 项

POI智能提取

必填参数：text_content

服务介绍

中文| 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_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

查看源码 项目主页

相关 MCP 服务

高德地图
@amap/amap-maps
高德地图是一个支持任何MCP协议客户端的服务器，允许用户轻松利用高德地图MCP服务器获取各种基于位置的服务。
12306-MCP车票查询工具
@Joooook/12306-mcp
基于Model Context Protocol (MCP) 的12306购票搜索服务器。提供了简单的API接口，允许大模型利用接口搜索12306购票信息。
百度地图
@baidu-maps/mcp
百度地图提供的MCP Server，包含10个符合MCP协议标准的API接口，涵盖逆地理编码、地点检索、路线规划等。 （正文语言为中文，无需翻译）
麦当劳MCP Server
MChina/mcd_mcp_server
暂无简介