MCP 客户端接入

如何让 WorkBuddy 操作你的纯血鸿蒙手机(MCP 接入教程)

介绍如何在电脑上将 WorkBuddy 通过 xiaobei-harmony-mcp 无线连接纯血鸿蒙手机,支持命令行自动写入 ~/.workbuddy/mcp.json 或界面「配置 MCP」手工填入。

兼容 HarmonyOS NEXT(API 24 及以上)更新日期:2026-11-14阅读时长:约 4 分钟

快速步骤概览

  1. 确认电脑已安装 Node.js(可用 npx),鸿蒙手机已完成小贝单机无线调试并与电脑连在同一 Wi-Fi。
  2. 运行 init 命令写入 ~/.workbuddy/mcp.json,或在 WorkBuddy 进入 插件 -> MCP 服务器 -> 配置 MCP 粘贴 XIAOBEI_MCP_CLIENT_ID 为 workbuddy 的配置。
  3. 发送「用小贝检查一下手机连接」拿到二维码或 4 位短码,在手机小贝「AI 连接」确认授权。

如果你在电脑上习惯用 WorkBuddy 处理日常办公或自动化小任务,接入小贝 MCP 后,就能在同个局域网里让 WorkBuddy 直接查看纯血鸿蒙真机屏幕并动手完成点击、滑动与输入。

准备条件

  1. 手机装好 小贝自动点击器,完成单机无线调试配对且账号会员处于有效状态。
  2. 电脑(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」手工填入

  1. 先生成一段带着专属 XIAOBEI_MCP_INSTANCE_ID 的 JSON 配置:
npx -y xiaobei-harmony-mcp config --client=workbuddy
  1. 打开 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"。

手机扫码连接与测试

  1. 确认 WorkBuddy 的 MCP 服务列表里 xiaobei-harmony 处于开启状态后,发一句:
用小贝检查一下手机连接。
  1. 浏览器会打开扫码页面(同时显示 4 位短码,10 分钟有效)。
  2. 打开纯血鸿蒙手机上的 小贝自动点击器 -> AI 连接,扫码或填短码,核对名字为 WorkBuddy 后点 「允许连接」。
  3. 回到 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 服务即可。