Baidu Map

🚀 百度地图 MCP Server

百度地图 MCP Server 全面兼容 MCP 协议，是国内首家支持该协议的地图服务方案。它提供 10 个标准 API 接口，涵盖逆地理编码、地点检索等功能。借助 MCP Python SDK 和 MCP Typescript SDK，各类支持 MCP 协议的智能体助手可快速接入使用。

🚀 快速开始

使用百度地图 MCP Server 主要通过 Python 和 Typescript 两种形式，下面分别介绍。

获取 AK

在选择两种方法之前，你需要在百度地图开放平台的控制台中创建一个服务端 AK，通过 AK 你才能够调用百度地图 API 能力。

Python 接入

如果你希望自定义百度地图 MCP Server 的能力，可以通过源码接入，方式详见Python 接入文档。

在 v1.1 版本更新中，我们通过 pypi 发布了百度地图 MCP Server：mcp-server-baidu-maps，你可以使用任意 Python 包管理工具轻松获取并快速配置使用。

安装

使用 uv（推荐）

使用uv时不需要特殊安装，我们将使用uvx直接运行mcp-server-baidu-maps。

使用 pip

或者你可以通过 pip 来安装mcp-server-baidu-maps

pip install mcp-server-baidu-maps

安装后，我们可以使用以下命令将其作为脚本运行：

python -m mcp_server_baidu_maps

配置

在任意 MCP 客户端（如 Claude.app）中添加如下配置，部分客户端下可能需要做一些格式化调整。

其中BAIDU_MAPS_API_KEY对应的值需要替换为你自己的 AK。

{
"mcpServers": {
"baidu-maps": {
"command": "uvx",
"args": ["mcp-server-baidu-maps"],
"env": {
"BAIDU_MAPS_API_KEY": ""
}
}
}
}

{
"mcpServers": {
"baidu-maps": {
"command": "python",
"args": ["-m", "mcp_server_baidu_maps"],
"env": {
"BAIDU_MAPS_API_KEY": ""
}
}
}
}

保存配置后，重启你的 MCP 客户端，即可使用百度地图 MCP Server。

Typescript 接入

nodejs 安装

通过 Typescript 接入，你只需要安装node.js。

当你在终端可以运行

node -v

则说明你的 node.js 已经安装成功。

配置

打开 Claude for Desktop 的 Setting，切换到 Developer，点击 Edit Config，用任意的 IDE 打开配置文件。

将以下配置添加到配置文件中，BAIDU_MAP_API_KEY 是访问百度地图开放平台 API 的 AK，在此页面中申请获取：

{
"mcpServers": {
"baidu-map": {
"command": "npx",
"args": [
"-y",
"@baidumap/mcp-server-baidu-map"
],
"env": {
"BAIDU_MAP_API_KEY": "xxx"
}
}
}
}

如果是 window 系统，json 需要添加单独的配置：

"mcpServers": {
"baidu-map": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@baidumap/mcp-server-baidu-map"
],
"env": {
"BAIDU_MAP_API_KEY": "xxx"
},
}
}

重启 Claude，此时设置面板已经成功加载了百度地图 MCP Server。在软件主界面对话框处可以看到有 8 个可用的 MCP 工具，点击可以查看详情。

效果

接下来就可以进行提问，验证出行规划小助手的能力了。

通过千帆 AppBuilder 平台接入

千帆平台接入，目前支持 SDK 接入或是 API 接入，通过 AppBuilder 构建一个应用，每个应用拥有一个独立的 app_id，在 python 文件中调用对应的 app_id，再调用百度地图 Python MCP Tool 即可。

模板代码可向下跳转，通过 SDK Agent && 地图 MCP Server，拿到导航路线及路线信息，并给出出行建议。

Agent 配置

前往千帆平台，新建一个应用，并发布。

将 Agent 的思考轮数调到 6。发布应用。

调用

此代码可以当作模板，以 SDK 的形式调用千帆平台上已经构建好且已发布的 App，再将 MCP Server 下载至本地，将文件相对路径写入代码即可。

（注意：使用实际的 app_id、token、query、mcp 文件）

import os
import asyncio
import appbuilder
from appbuilder.core.console.appbuilder_client.async_event_handler import (
AsyncAppBuilderEventHandler,
)
from appbuilder.mcp_server.client import MCPClient
class MyEventHandler(AsyncAppBuilderEventHandler):
def __init__(self, mcp_client):
super().__init__()
self.mcp_client = mcp_client
def get_current_weather(self, location=None, unit="摄氏度"):
return "{} 的温度是 {} {}".format(location, 20, unit)
async def interrupt(self, run_context, run_response):
thought = run_context.current_thought
# 绿色打印
print("\033[1;31m", "-> Agent 中间思考: ", thought, "\033[0m")
tool_output = []
for tool_call in run_context.current_tool_calls:
tool_res = ""
if tool_call.function.name == "get_current_weather":
tool_res = self.get_current_weather(**tool_call.function.arguments)
else:
print(
"\033[1;32m",
"MCP工具名称: {}, MCP参数:{}\n".format(tool_call.function.name, tool_call.function.arguments),
"\033[0m",
)
mcp_server_result = await self.mcp_client.call_tool(
tool_call.function.name, tool_call.function.arguments
)
print("\033[1;33m", "MCP结果: {}\n\033[0m".format(mcp_server_result))
for i, content in enumerate(mcp_server_result.content):
if content.type == "text":
tool_res += mcp_server_result.content[i].text
tool_output.append(
{
"tool_call_id": tool_call.id,
"output": tool_res,
}
)
return tool_output
async def success(self, run_context, run_response):
print("\n\033[1;34m", "-> Agent 非流式回答: ", run_response.answer, "\033[0m")
async def agent_run(client, mcp_client, query):
tools = mcp_client.tools
conversation_id = await client.create_conversation()
with await client.run_with_handler(
conversation_id=conversation_id,
query=query,
tools=tools,
event_handler=MyEventHandler(mcp_client),
) as run:
await run.until_done()
### 用户Token
os.environ["APPBUILDER_TOKEN"] = (
""
)
async def main():
appbuilder.logger.setLoglevel("DEBUG")
### 发布的应用ID
app_id = ""
appbuilder_client = appbuilder.AsyncAppBuilderClient(app_id)
mcp_client = MCPClient()

### 注意这里的路径为MCP Server文件在本地的相对路径
await mcp_client.connect_to_server(".//map.py")
print(mcp_client.tools)
await agent_run(
appbuilder_client,
mcp_client,
'开车导航从北京到上海',
)
await appbuilder_client.http_client.session.close()
if __name__ == "__main__":
loop = asyncio.get_event_loop()
loop.run_until_complete(main())

效果

经过 Agent 自己的思考，通过调用 MCPServer 地点检索、地理编码服务、路线规划服务等多个 tool，拿到导航路线及路线信息，并给出出行建议。

实际用户请求：“请为我计划一次北京赏花一日游。尽量给出更舒适的出行安排，当然，也要注意天气状况。”

思考过程

Agent 结果

✨ 主要特性

• 百度地图 API 全面兼容 MCP 协议，是国内首家兼容该协议的地图服务商。
• 提供 10 个符合 MCP 协议标准的 API 接口，功能丰富，涵盖逆地理编码、地点检索、路线规划等。
• 依赖 MCP Python SDK 和 MCP Typescript SDK 开发，支持多种智能体助手快速接入。

📚 详细文档

工具

1. 地理编码 map_geocode

   • 描述：将地址解析为对应的位置坐标，地址结构越完整，地址内容越准确，解析的坐标精度越高。
   • 参数：address 地址信息
   • 输出：location 纬经度坐标

2. 逆地理编码 map_reverse_geocode

   • 描述：根据纬经度坐标，获取对应位置的地址描述、所在行政区划、道路以及相关 POI 等信息。
   • 参数：
     • latitude 纬度坐标
     • longitude 经度坐标
   • 输出：formatted_address, uid, addressComponent 等语义化地址信息

3. 地点检索 map_search_places

   • 描述：支持检索城市内的地点信息（最小到 city 级别），也可支持圆形区域内的周边地点信息检索。
   • 参数：
     • query 检索关键词，可用名称或类型，多关键字使用英文逗号隔开，如：query=天安门,美食
     • tag 检索的类型偏好，格式为 tag=美食 或者 tag=美食,酒店
     • region 检索的行政区划，格式为 region=cityname 或 region=citycode
     • location 圆形检索中心点纬经度坐标，格式为 location=lat,lng
     • radius 圆形检索的半径
   • 输出：POI 列表，包含 name, location, address 等

4. 地点详情检索 map_place_details

   • 描述：根据 POI 的 uid，检索其相关的详情信息，如评分、营业时间等（不同类型 POI 对应不同类别详情数据）。
   • 参数：uid POI 的唯一标识
   • 输出：POI 详情，包含 name, location, address, brand, price 等

5. 批量算路 map_distance_matrix

   • 描述：根据起点和终点坐标计算路线规划距离和行驶时间，批量算路目前支持驾车、骑行、步行。
   • 参数：
     • origins 起点纬经度列表，格式为 origins=lat,lng，多个起点使用 | 分隔
     • destinations 终点纬经度列表，格式为 destinations=lat,lng，多个终点使用 | 分隔
     • mode 算路类型，可选取值包括 driving, walking, riding，默认使用 driving
   • 输出：每条路线的耗时和距离，包含 distance, duration 等

6. 路线规划 map_directions

   • 描述：根据起终点坐标规划出行路线和耗时，可指定驾车、步行、骑行、公交等出行方式。
   • 参数：
     • origin 起点纬经度，格式为 origin=lat,lng
     • destination 终点纬经度，格式为 destination=lat,lng
     • model 出行类型，可选取值包括 driving, walking, riding, transit，默认使用 driving
   • 输出：路线详情，包含 steps, distance, duration 等

7. 天气查询 map_weather

   • 描述：通过行政区划或是经纬度坐标查询实时天气信息及未来 5 天天气预报（通过 location 经纬度坐标查询天气需用户拥有高级权限）。
   • 参数：
     • district_id 行政区划编码
     • location 经纬度坐标，格式为 location=lng, lat
   • 输出：天气信息，包含 temperature, weather, wind 等

8. IP 定位 map_ip_location

   • 描述：根据请求的 IP 获取当前请求的位置（定位到城市），如果请求参数 ip 为 IPv6 则需要高级权限。
   • 参数：ip 请求的 IP 地址
   • 输出：当前所在城市和城市中点 location

9. 实时路况查询 map_road_traffic

   • 描述：查询实时交通拥堵情况，可通过指定道路名和区域形状（矩形、多边形、圆形）进行实时路况查询。
   • 参数：
     • model 路况查询类型（可选值包括 road, bound, polygon, around，默认使用 road）
     • road_name 道路名称和道路方向，model=road 时必传（如：朝阳路南向北）
     • city 城市名称或城市 adcode，model=road 时必传（如：北京市）
     • bounds 区域左下角和右上角的纬经度坐标，model=bound 时必传（如：39.9,116.4;39.9,116.4）
     • vertexes 多边形区域的顶点纬经度坐标，model=polygon 时必传（如：39.9,116.4;39.9,116.4;39.9,116.4;39.9,116.4）
     • center 圆形区域的中心点纬经度坐标，model=around 时必传（如：39.912078,116.464303）
     • radius 圆形区域的半径（米），取值 [1,1000]，model=around 时必传（如：200）
   • 输出：路况信息，包含 road_name, traffic_condition 等

10. POI 智能提取 map_poi_extract

    • 描述：当所给的 API_KEY 带有高级权限才可使用，根据所给文本内容提取其中的相关 POI 信息。
    • 参数：text_content 用于提取 POI 的文本描述信息（完整的旅游路线、行程规划、景点推荐描述等文本内容，例如：新疆独库公路和塔里木湖太美了，从独山子大峡谷到天山神秘大峡谷也是很不错的体验）
    • 输出：相关的 POI 信息，包含 name, location 等

说明

在百度地图 MCP Server 中传入的部分参数规格：

• 行政区划编码均采用百度 adcode 映射表。
• 经纬度坐标均采用国测局经纬度坐标 gcj02ll，详见百度坐标系。
• 类型等中文字符串参数应符合百度 POI 类型标准。

📄 许可证

MIT © baidu - maps

🔧 技术细节

授权

百度地图 MCP Server 中的部分高级能力需要申请高级权限才可使用。如有需要的话，请联系我们。

反馈

在使用百度地图 MCP Server 时遇到的任何问题，欢迎通过 issue 或是百度地图开放平台反馈给我们，我们也欢迎每一个积极的 PR，非常感谢各位的支持与贡献❤️

更新