CodeBuddy 中配置与使用百度地图 MCP 全流程指南
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 场景。

相关新闻

[特殊字符] HTTPS 性能优化完全指南:Spring Boot + Nginx 如何让 TLS 握手快 40%

[特殊字符] HTTPS 性能优化完全指南:Spring Boot + Nginx 如何让 TLS 握手快 40%

HTTPS 真的比 HTTP 慢吗?那是你没做对优化。 你好,我是老张。 很多同学对 HTTPS 的刻板印象是“慢”——“加了 TLS 握手,肯定比 HTTP 慢嘛”。然后你问他:“慢多少?怎么优化?”他就答不上来了。 事实是&…

2026/11/18 12:16:14 阅读更多 →
别再说“转IT就是做码农“了!这个方向大专可冲、越老越吃香,2026年还在疯狂招人

别再说“转IT就是做码农“了!这个方向大专可冲、越老越吃香,2026年还在疯狂招人

"实在不行,就去报个培训班转IT吧。"这句话,你是不是也说过?或者——至少听过?2026年,经济还在缓慢爬坡,传统行业岗位收缩,考公考编卷成麻花。无数人把目光投向了IT行业,指…

2026/11/16 23:43:05 阅读更多 →
从0到Offer:6个月拿下第一份网络安全工作的完整实战地图(第十二弹·求职收官篇)

从0到Offer:6个月拿下第一份网络安全工作的完整实战地图(第十二弹·求职收官篇)

前面十一篇文章,我带你走完了从SQL注入到内网渗透、从提权到权限维持的全过程。 今天这篇是这个系列的收官之作——手把手教你如何把前面学的一切,变成一张实实在在的Offer。 全文约2200字,阅读约8分钟。这篇是你通往网安职场最后一张“地图”…

2026/11/16 15:32:59 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/18 13:59:04 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/18 15:33:23 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/18 17:05:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/18 14:33:19 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/18 17:05:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/18 14:13:08 阅读更多 →

日新闻

周新闻

月新闻