如何让 CodeBuddy 操作你的纯血鸿蒙手机(MCP 接入教程)
教你把腾讯 CodeBuddy 研发助手接到 HarmonyOS NEXT 真机上,通过局域网 MCP 直接看手机界面、找控件并执行点按滑动验证。
快速步骤概览
- 确认电脑已安装 Node.js(可用 npx),鸿蒙手机完成小贝无线调试并连入同一 Wi-Fi。
- 在 CodeBuddy 里发送自动接入指令,或在 CodeBuddy 的 MCP 设置里手动粘入 codebuddy 对应的 JSON 配置。
- 发送「用小贝检查一下手机连接」拉起配对二维码,并在手机小贝「AI 连接」点击允许连接。
用 CodeBuddy 写代码或排查界面问题时,把小贝的 xiaobei-harmony-mcp 接进 CodeBuddy 之后,就能在同一局域网下直接查看 HarmonyOS NEXT 手机画面、核对界面控件,甚至直接帮着把回归操作走一遍。
准备条件
- 手机已经装好 小贝自动点击器 并完成单机无线调试开启,账号处于登录且会员有效状态。
- 电脑(Mac 或 Windows)装好了 Node.js(确认终端可运行
npx -v),且和手机连在同一个 Wi-Fi 下。
方法一:发一句话让 CodeBuddy 自动接上
打开 https://mcp.aoqi360.com/?client=codebuddy#connect,或者把下面这段话直接发给 CodeBuddy:
请阅读小贝接入教程:https://mcp.aoqi360.com/autoclicker/llms.txt,帮我在 "CodeBuddy" 中连接小贝。
CodeBuddy 会按照自身的 MCP 配置格式替你把 xiaobei-harmony 服务添上(不会改动你原有的其他 MCP 工具)。如果环境受限无法自动写配置,它会给出完整字段供你手动导入。
方法二:生成凭证后手动贴进 CodeBuddy MCP 设置
- 在电脑终端运行下方命令,生成一份带着固定
XIAOBEI_MCP_INSTANCE_ID的codebuddy配置:
npx -y xiaobei-harmony-mcp config --client=codebuddy
- 打开 CodeBuddy 的 MCP 配置面板,添加本地 STDIO 服务
xiaobei-harmony,参数与环境变量核对如下:
{
"mcpServers": {
"xiaobei-harmony": {
"command": "npx",
"args": ["-y", "xiaobei-harmony-mcp"],
"env": {
"XIAOBEI_MCP_CLIENT_ID": "codebuddy",
"XIAOBEI_MCP_INSTANCE_ID": "替换为命令行生成的UUID",
"XIAOBEI_MCP_APP_ID": "autoclicker",
"XIAOBEI_MCP_HUB_URL": "https://api.aoqi360.com"
}
}
}
}
Windows 环境若直接写
npx无法拉起,请改为npx.cmd。每个客户端实例保存固定一个 UUID 即可,不要每次修改。
手机扫码允许连接
- 保存并确认
xiaobei-harmonyMCP 已启用后,在 CodeBuddy 对话框发送:
用小贝检查一下手机连接。
- 此时会打开二维码配对页面(同时给出 4 位配对码,10 分钟有效)。
- 拿起鸿蒙手机进入 小贝 -> AI 连接,扫描二维码或输入 4 位短码,确认客户端显示为
CodeBuddy,点 「允许连接」。 - 授权完成之后,就能在 CodeBuddy 里让助手直接查看当前真机页面并按步骤验证交互。
断开与隐私边界
- 所有手机截图、控件节点和点击轨迹只在你自己的 Wi-Fi 局域网中点对点收发,云端不会留存画面。
- 运行途中可随时从悬浮小窗、实况通知栏暂停或结束,也能随时在小贝「AI 连接」页面关闭权限。
相关常见问题
CodeBuddy 配好以后,换一个代码项目还要重新扫码吗?
如果你是把 MCP 加在 CodeBuddy 的全局/用户级配置里,且一直保留着同一个 XIAOBEI_MCP_INSTANCE_ID,切换项目目录后不用重新扫码,可以直接继续用。
如果 CodeBuddy 已经配过但手机上当前启用的是 Cursor 怎么办?
当多个客户端都在同一台手机授权过时,只需在手机端「小贝 -> AI 连接」里把当前客户端切回 CodeBuddy 即可,切完在 CodeBuddy 里重新验证一次连接就能立即生效。