DeepSeek 导航网:百度地图 API 现已全面兼容 MCP 协议,是国内首家兼容 MCP 协议的地图服务商。百度地图提供的 MCP Server ,包含 10 个符合 MCP 协议标准的 API 接口,涵盖逆地理编码、地点检索、路线规划等。
依赖 MCP Python SDK 和 MCP Typescript SDK 开发,任意支持 MCP 协议的智能体助手(如 Claude、Cursor 以及千帆 AppBuilder 等)都可以快速接入。
开始
使用百度地图 MCP Server 主要通过两种形式,分别是Python
和Typescript
,下面分别介绍。
获取 AK
在选择两种方法之前,你需要在百度地图开放平台的控制台中创建一个服务端 AK ,通过 AK 你才能够调用百度地图 API 能力。
Python 接入
如果你希望自定义百度地图 MCP Server 的能力,可以通过源码接入,方式详见Python 接入文档。
在 v1.1 版本更新中,我们通过 pypi 发布了百度地图 MCP Server:mcp-server-baidu-maps,你可以使用任意 Python 包管理工具轻松获取并快速配置使用。
工具
地理编码
map_geocode
- 描述: 将地址解析为对应的位置坐标, 地址结构越完整, 地址内容越准确, 解析的坐标精度越高
- 参数:
address
地址信息 - 输出:
location
纬经度坐标
逆地理编码
map_reverse_geocode
- 描述: 根据纬经度坐标, 获取对应位置的地址描述, 所在行政区划, 道路以及相关 POI 等信息
- 参数:
latitude
纬度坐标longitude
经度坐标
- 输出:
formatted_address
,uid
,addressComponent
等语义化地址信息
地点检索
map_search_places
- 描述: 支持检索城市内的地点信息(最小到
city
级别), 也可支持圆形区域内的周边地点信息检索 - 参数:
query
检索关键词, 可用名称或类型, 多关键字使用英文逗号隔开, 如:query=天安门,美食
tag
检索的类型偏好, 格式为tag=美食
或者tag=美食,酒店
region
检索的行政区划, 格式为region=cityname
或region=citycode
location
圆形检索中心点纬经度坐标, 格式为location=lat,lng
radius
圆形检索的半径
- 输出: POI 列表, 包含
name
,location
,address
等
- 描述: 支持检索城市内的地点信息(最小到
地点详情检索
map_place_details
- 描述: 根据 POI 的 uid ,检索其相关的详情信息, 如评分、营业时间等(不同类型 POI 对应不同类别详情数据)
- 参数:
uid
POI 的唯一标识 - 输出: POI 详情, 包含
name
,location
,address
,brand
,price
等
批量算路
map_directions_matrix
- 描述: 根据起点和终点坐标计算路线规划距离和行驶时间,支持驾车、骑行、步行。步行时任意起终点之间的距离不得超过 200KM ,驾车批量算路一次最多计算 100 条路线,起终点个数之积不能超过 100 。
- 参数:
origins
起点纬经度列表, 格式为origins=lat,lng
,多个起点用|
分隔destinations
终点纬经度列表, 格式为destinations=lat,lng
,多个终点用|
分隔model
算路类型,可选取值包括driving
,walking
,riding
,默认使用driving
- 输出: 每条路线的耗时和距离, 包含
distance
,duration
等
路线规划
map_directions
- 描述: 根据起终点位置名称或经纬度坐标规划出行路线和耗时, 可指定驾车、步行、骑行、公交等出行方式
- 参数:
origin
起点位置名称或纬经度, 格式为origin=lat,lng
destination
终点位置名称或纬经度, 格式为destination=lat,lng
model
出行类型, 可选取值包括driving
,walking
,riding
,transit
, 默认使用driving
- 输出: 路线详情,包含
steps
,distance
,duration
等
天气查询
map_weather
- 描述: 通过行政区划或是经纬度坐标查询实时天气信息及未来 5 天天气预报
- 参数:
district_id
行政区划编码location
经纬度坐标, 格式为location=lng, lat
- 输出: 天气信息, 包含
temperature
,weather
,wind
等
IP 定位
map_ip_location
- 描述: 通过所给 IP 获取具体位置信息和城市名称, 可用于定位 IP 或用户当前位置。可选参数
ip
,如果为空则获取本机 IP 地址(支持 IPv4 和 IPv6)。 - 参数:
ip
(可选)需要定位的 IP 地址
- 输出: 当前所在城市和城市中点
location
- 描述: 通过所给 IP 获取具体位置信息和城市名称, 可用于定位 IP 或用户当前位置。可选参数
实时路况查询
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
等
POI 智能提取
map_poi_extract
- 描述: 当所给的
API_KEY
带有高级权限才可使用, 根据所给文本内容提取其中的相关 POI 信息。 - 参数:
text_content
用于提取 POI 的文本描述信息 (完整的旅游路线,行程规划,景点推荐描述等文本内容, 例如: 新疆独库公路和塔里木湖太美了, 从独山子大峡谷到天山神秘大峡谷也是很不错的体验) - 输出:相关的 POI 信息,包含
name
,location
等
- 描述: 当所给的
通过 IP-API.com 提供 IP 地理位置