首页/新闻资讯/正文详情

CodeBuddy 中配置与使用百度地图 MCP 全流程指南

发布时间:2026/11/22 9:15:41 来源:云帆数科 栏目:资讯中心
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 场景。

相关推荐

嵌入式C语言状态机设计与实现指南
嵌入式C语言状态机设计与实现指南

1. 状态机在嵌入式系统中的核心价值在嵌入式系统开发中,状态机(Finite State Machine, FSM)是管理复杂逻辑的利器。我曾在开发工业控制器时,面对多达20种设备状态和50余种状态转换条件,传统的if-else嵌套让代码变得难以维护。直到采用状态机设… · 2026/9/5 1:41:12

Windows 11 25H2版本解析与安装指南
Windows 11 25H2版本解析与安装指南

1. Windows 11 25H2版本概述Windows 11 25H2是微软计划于2025年9月发布的重大功能更新版本。作为Windows 11的第三个年度更新,25H2版本将带来一系列性能改进和新功能增强。这个版本特别值得关注的是它对ARM64架构的深度优化,以及对传统x64架构的持续支持… · 2026/9/21 10:01:17

Linux命令行操作指南:从入门到高效运维
Linux命令行操作指南:从入门到高效运维

1. Linux命令行基础认知 刚接触Linux系统的朋友,最常问的问题就是:"黑乎乎的终端窗口里到底能干什么?"作为从1999年就开始使用Linux的老用户,我可以负责任地告诉你:命令行才是Linux系统的灵魂所在。与图形界… · 2026/9/12 5:04:31

杨凌示范区高压电工证值不值得考?实操考试心里没底怕挂科怎么办
杨凌示范区高压电工证值不值得考?实操考试心里没底怕挂科怎么办

杨凌示范区高压电工证值不值得考?实操考试心里没底怕挂科怎么办 实操考试心里没底怕挂科,这几乎是所有报考高压电工证的学员都绕不开的焦虑。尤其是在杨凌示范区,高压电工证不仅关乎个人职业发展,还直接影响到是否能进入工地、工厂等高风险作业现场。很多… · 2026/11/22 9:15:20

安监局电工证考题答案值不值得考?证书过期了不知道怎么复审延期怎么办
安监局电工证考题答案值不值得考?证书过期了不知道怎么复审延期怎么办

安监局电工证考题答案值不值得考?证书过期了不知道怎么复审延期怎么办 证书过期了,不知道怎么复审延期?你是不是也遇到过这种情况?特种作业证到期后,很多从业者都会感到焦虑,怕影响工作、怕被处罚、怕失去岗位。今天我们就来聊聊【安监局电工证考题答案… · 2026/11/22 9:15:20

武汉三级电工证怎么考 电子证书怎么领取
武汉三级电工证怎么考 电子证书怎么领取

武汉三级电工证怎么考 电子证书怎么领取 你现在正站在一个岔路口,手里攥着一份简历,却因为 没有电工证 而被用人单位拒之门外。你知道,没有特种作业证,连面试资格都没有,更别说找到一份稳定的工作了。而你最担心的,就是 武汉三级电工证怎么考… · 2026/11/22 9:15:20

西安ic卡电工证怎么考才靠谱?全国通用证书别踩坑
西安ic卡电工证怎么考才靠谱?全国通用证书别踩坑

西安ic卡电工证怎么考才靠谱?全国通用证书别踩坑 怕考不过白交培训费?西安ic卡电工证正在成为电工行业的“硬通货”,但不是每个培训机构都能保证你顺利取证。尤其是现在,很多电工证被要求全国通用,选错机构就意味着白花培训费,还可能影响后续的就业… · 2026/11/22 9:15:20

首次考电工证考哪个好 值不值得考这事儿真得搞明白
首次考电工证考哪个好 值不值得考这事儿真得搞明白

首次考电工证考哪个好 值不值得考这事儿真得搞明白 证书过期了不知道怎么复审延期,这事儿我太懂了。我自己当初考电工证的时候,就差点因为没注意复审时间,让手里好不容易拿到的证白搭了。现在你要是问“首次考电工证考哪个好”,我建议你先搞清楚这个证到… · 2026/11/22 9:15:20

电工证高空证二合一含金量有多高?怕考不过白交培训费的看过来
电工证高空证二合一含金量有多高?怕考不过白交培训费的看过来

电工证高空证二合一含金量有多高?怕考不过白交培训费的看过来 怕考不过白交培训费?你不是一个人!特别是像你这种信阳浉河区劳务班组负责人,手头一堆证要办,一不小心就掉进培训机构的坑里。今天咱们不绕弯子,直接说说【电工证高空证二合一】到底值不值得… · 2026/11/22 9:14:20

平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定
平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定

平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 你是不是也经常在网上看到“平价的电工证查询”这样的关键词,但又不知道去哪报名,怕被中介坑?特别是像你这样的平顶山学员,既想考个正规电工证,又怕花冤枉钱走弯路。别担心,这篇保姆级教程就是… · 2026/11/22 0:00:42

麻阳考电工证在哪里考内部消息你知道吗
麻阳考电工证在哪里考内部消息你知道吗

麻阳考电工证在哪里考内部消息你知道吗 不知道去哪报名怕被中介坑, 内部消息 告诉你,麻阳考电工证不一定要去外地,本地其实也有正规渠道,但很多人因为不了解流程和资质,反而被坑了钱还考不到证。今天我就从一个干了这么多年特种作业培训的“老江湖”角… · 2026/11/22 0:00:43

揭阳普宁电工证换证怎么操作?良心建议帮你理清流程
揭阳普宁电工证换证怎么操作?良心建议帮你理清流程

揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 之前考的证在外省能不能转过来?这是很多已经在外地工作、现在想回揭阳普宁发展的电工朋友最关心的问题。如果你也是其中之一,那这篇文章就是为你们量身定制的,从换证流程到避坑建议,良心建议全给你讲透… · 2026/11/22 0:00:43

平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定
平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定

平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 你是不是也经常在网上看到“平价的电工证查询”这样的关键词,但又不知道去哪报名,怕被中介坑?特别是像你这样的平顶山学员,既想考个正规电工证,又怕花冤枉钱走弯路。别担心,这篇保姆级教程就是… · 2026/11/22 0:00:42

麻阳考电工证在哪里考内部消息你知道吗
麻阳考电工证在哪里考内部消息你知道吗

麻阳考电工证在哪里考内部消息你知道吗 不知道去哪报名怕被中介坑, 内部消息 告诉你,麻阳考电工证不一定要去外地,本地其实也有正规渠道,但很多人因为不了解流程和资质,反而被坑了钱还考不到证。今天我就从一个干了这么多年特种作业培训的“老江湖”角… · 2026/11/22 0:00:43

揭阳普宁电工证换证怎么操作?良心建议帮你理清流程
揭阳普宁电工证换证怎么操作?良心建议帮你理清流程

揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 之前考的证在外省能不能转过来?这是很多已经在外地工作、现在想回揭阳普宁发展的电工朋友最关心的问题。如果你也是其中之一,那这篇文章就是为你们量身定制的,从换证流程到避坑建议,良心建议全给你讲透… · 2026/11/22 0:00:43

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:37

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:30

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:32

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码