如何让 WorkBuddy 操作你的纯血鸿蒙手机(MCP 接入教程)
介绍如何在电脑上将 WorkBuddy 通过 xiaobei-harmony-mcp 无线连接纯血鸿蒙手机,支持命令行自动写入 ~/.workbuddy/mcp.json 或界面「配置 MCP」手工填入。
快速步骤概览
- 确认电脑已安装 Node.js(可用 npx),鸿蒙手机已完成小贝单机无线调试并与电脑连在同一 Wi-Fi。
- 运行 init 命令写入 ~/.workbuddy/mcp.json,或在 WorkBuddy 进入 插件 -> MCP 服务器 -> 配置 MCP 粘贴 XIAOBEI_MCP_CLIENT_ID 为 workbuddy 的配置。
- 发送「用小贝检查一下手机连接」拿到二维码或 4 位短码,在手机小贝「AI 连接」确认授权。
如果你在电脑上习惯用 WorkBuddy 处理日常办公或自动化小任务,接入小贝 MCP 后,就能在同个局域网里让 WorkBuddy 直接查看纯血鸿蒙真机屏幕并动手完成点击、滑动与输入。
准备条件
- 手机装好 小贝自动点击器,完成单机无线调试配对且账号会员处于有效状态。
- 电脑(Mac 或 Windows)已安装 Node.js(终端可用
npx),与手机连着同一个 Wi-Fi。
方法一:直接在 WorkBuddy 里发一句提示词
打开 https://mcp.aoqi360.com/?client=workbuddy#connect,或把下面这句话直接发进 WorkBuddy 对话框:
请阅读小贝接入教程:https://mcp.aoqi360.com/autoclicker/llms.txt,帮我在 "WorkBuddy" 中连接小贝。
WorkBuddy 会读取官方文档并按提示引导写入 xiaobei-harmony 配置,或给你列好可直接粘贴的 JSON 内容。
方法二:通过命令或界面配置 ~/.workbuddy/mcp.json
方式 A:一条命令自动合并写入(推荐)
Mac / Linux 终端直接运行(只追加 xiaobei-harmony 节点,不会覆盖你原本配置好的其它 MCP):
npx -y xiaobei-harmony-mcp init --client=workbuddy --config="$HOME/.workbuddy/mcp.json"
Windows PowerShell 可运行:
npx -y xiaobei-harmony-mcp init --client=workbuddy --config="$HOME\.workbuddy\mcp.json"
方式 B:在客户端界面「配置 MCP」手工填入
- 先生成一段带着专属
XIAOBEI_MCP_INSTANCE_ID的 JSON 配置:
npx -y xiaobei-harmony-mcp config --client=workbuddy
- 打开 WorkBuddy -> 插件 -> MCP 服务器 -> 配置 MCP,把
xiaobei-harmony节点放进mcpServers里(请务必使用上一步终端为你生成的 UUID 并固定保存):
{
"mcpServers": {
"xiaobei-harmony": {
"command": "npx",
"args": ["-y", "xiaobei-harmony-mcp"],
"env": {
"XIAOBEI_MCP_CLIENT_ID": "workbuddy",
"XIAOBEI_MCP_INSTANCE_ID": "替换为上一步生成的UUID",
"XIAOBEI_MCP_APP_ID": "autoclicker",
"XIAOBEI_MCP_HUB_URL": "https://api.aoqi360.com"
}
}
}
}
Windows 如果遇到找不到
npx,把"npx"改成"npx.cmd"。
手机扫码连接与测试
- 确认 WorkBuddy 的 MCP 服务列表里
xiaobei-harmony处于开启状态后,发一句:
用小贝检查一下手机连接。
- 浏览器会打开扫码页面(同时显示 4 位短码,10 分钟有效)。
- 打开纯血鸿蒙手机上的 小贝自动点击器 -> AI 连接,扫码或填短码,核对名字为 WorkBuddy 后点 「允许连接」。
- 回到 WorkBuddy,就能让它先看一眼真机屏幕,然后顺着步骤替你打开界面、翻页点击或核对表单输入。
多客户端切换与隐私保护
- 手机小贝「AI 连接」页面会保留你授权过的各个客户端(如 CubeAgent、豆包 Work、WorkBuddy 等),平时随开随用,同一时间只启用一个。
- 手机画面和点击动作只通过你本机的无线局域网点对点通信,云端配对服务不接收手机截图。
相关常见问题
WorkBuddy 的 MCP 配置文件在哪里?可以直接用命令自动写入吗?
WorkBuddy 会在用户主目录读取 ~/.workbuddy/mcp.json 里的 mcpServers 字段。你可以在客户端界面打开 插件 -> MCP 服务器 -> 配置 MCP 手工粘贴,也可以直接运行 npx -y xiaobei-harmony-mcp init --client=workbuddy --config="$HOME/.workbuddy/mcp.json" 自动合并写入,不会覆盖已有服务。
Windows 上在 WorkBuddy 里连不上小贝工具怎么办?
先检查 JSON 里有没有把 "command" 从 "npx" 改成 "npx.cmd",然后确认终端执行 npx -v 能正常输出版本号,修改保存后重启一次 xiaobei-harmony 服务即可。