CodeBuddy 中配置与使用百度地图 MCP 全流程指南本指南汇总了在 CodeBuddy 里从零接入百度地图 MCP、踩坑排查到实战跑通「地址转坐标 搜周边咖啡店」的完整过程。一、准备工作申请 API KeyAK打开 百度地图开放平台控制台注册 / 登录 → 创建**「服务端」**类型应用拿到AKAPI Key关键一步在应用里启用「MCP (SSE)」服务否则可能调不通或性能较差⚠️ AK 属于敏感凭证明文存在mcp.json中切勿提交到 git 仓库注博客https://blog.csdn.net/badao_liumang_qizhi二、写入 MCP 配置mcp.json编辑C:\Users\admin\.codebuddy\mcp.json在mcpServers中追加baidu-map:{command:D:/SoftWare/node22/npx.cmd,args:[-y,baidumap/mcp-server-baidu-map],env:{BAIDU_MAP_API_KEY:你的AK},description:百度地图LBS服务地理编码/POI/路线/天气/交通,disabled:false}两种接入方式对比方式包名环境变量Node.js推荐baidumap/mcp-server-baidu-mapBAIDU_MAP_API_KEY无 SPythonmcp-server-baidu-mapsBAIDU_MAPS_API_KEY有 S⚠️ 变量名两个版本不一样Node 版用BAIDU_MAP_API_KEYPython 版才用BAIDU_MAPS_API_KEY配错会导致鉴权失败。生效方式写入后在 CodeBuddy 对该 MCP 做禁用 → 启用或重启 CodeBuddy。三、工具清单10 个标准接口工具作用map_geocode地址 → 经纬度坐标map_reverse_geocode坐标 → 地址/区域/周边 POImap_search_places按关键词/类型/半径搜 POImap_place_details按 POI 唯一 ID 取详情map_directions两点路线规划驾车/步行/骑行/公交map_directions_matrix批量路线矩阵多起点→多终点map_weather按区域/坐标查实时 预报天气map_ip_location通过 IP 定位城市 坐标map_road_traffic查道路/区域实时交通状况map_poi_extract*从自由文本提取 POI需高级权限四、踩坑排查APP IP 校验失败现象首次调用map_geocode返回Geocoding failed: APP IP校验失败根因该 AK 在开放平台开启了「IP 白名单」校验当前机器发起请求的出口 IP 不在白名单中被服务端拒绝。注意请求能到达百度服务器说明机器本身能联网问题只在白名单。误入的方案 BSN 校验—— 不可行尝试改用 AK SK 的 SN 签名模式但查官方仓库baidu-maps/mcp确认该 MCP Server只支持 AK 鉴权没有任何 SK / SN 签名的环境变量也不会自己算签名即使在开放平台把 AK 类型改为 SN 校验MCP 发出的请求不带sn参数百度照样拒绝结论对 MCP 唯一友好的是 IP 白名单模式方案 B 不成立。五、正确解法方案 A —— 加 IP 白名单查当前公网出口 IP本机实测打开 百度地图开放平台控制台找到该 AK 对应的应用 → 编辑 →IP 白名单加上临时调试可填0.0.0.0/0放开所有 IP用完改回保存后直接重跑即可无需重启 MCP若以后又报「APP IP校验失败」多半是公网 IP 变了动态分配重新查 IP 再加一次白名单即可。六、实战跑通地址转坐标 搜周边咖啡店步骤 1地理编码地址 → 坐标调用map_geocode输入北京市海淀区中关村大街经度 (lng)116.324104纬度 (lat)39.981942解析级别道路level道路步骤 2检索周边咖啡店调用map_search_places中心点39.98194156690778,116.32410398706402关键词咖啡。该 MCP 的search_places未暴露radius参数故对返回结果用Haversine 直线距离过滤 2km 边界。结果共 10 家按由近及远#名称距中心地址1书和咖啡~61 m海淀区中关村大街31号2瑞幸咖啡(海淀剧院店)~139 m中关村大街28号-1号一层3OKCOFFEE福气咖啡(海淀文化艺术大厦店)~211 m中关村大街甲28号海淀文化艺术大厦B座7层4弄咖啡 GNU COFFEE(银网中心店)~270 m知春路113号银网中心-B座F15MANNER COFFEE(新中关购物中心店)~316 m中关村大街19号新中关大厦KL1056MMaoCafe猫叔咖啡(人民大学店)~445 m人民大学北路静园7号楼1层7瑞幸咖啡(互联网金融中心店)~534 m丹棱街1号互联网金融中心一层大堂8瑞幸咖啡(科学院南路店)~632 m中关村科学院南路17号一层罗森9MOJO(中关村店)~666 m中关村大街11号e世界财富中心A座底商10瑞幸咖啡(四通大厦店)~721 m海淀大街2号四通大厦一层大堂距离为直线估算实际步行/驾车距离更长坐标为百度 POI 数据可能与门牌有微小偏差。七、关键要点速记配置变量名Node 版BAIDU_MAP_API_KEY无 S别配错。鉴权只有 AK 一种SN 校验在 MCP 层无法实现老老实实走 IP 白名单。白名单排查报「APP IP校验失败」 出口 IP 未加白查https://ip.3322.net加进去。禁用 → 启用改完mcp.json要重启或切换连接才生效。经典三件套map_geocodemap_search_placesmap_directions覆盖绝大多数 LBS 场景。
