MCP 客户端接入

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

一步步教你在 Cherry Studio 桌面客户端设置里添加 xiaobei-harmony 本地 STDIO MCP 服务,扫码连上你的 HarmonyOS NEXT 真机。

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

快速步骤概览

  1. 在电脑确认已安装 Node.js,并运行一次 npx -y xiaobei-harmony-mcp config --client=cherry 生成专属 UUID。
  2. 打开 Cherry Studio「设置 -> MCP 服务器」,新建类型为 STDIO 的 xiaobei-harmony 服务并填入命令、参数和 4 个环境变量。
  3. 在当前使用的助手对话窗口里打开「xiaobei-harmony」工具开关。
  4. 发送「用小贝检查一下手机连接」,用手机小贝扫码或填 4 位配对码点允许。

Cherry Studio 的 MCP 功能是直接在桌面端图形设置里填写的,不用到处翻配置文件,也不建议用口令瞎改内部数据库。跟着下面这几步,几分钟就能让 Cherry Studio 直接操作你的纯血鸿蒙手机。

开始前的准备

  1. 手机装好 小贝自动点击器,做完单机无线调试配置,保证账号已登录且会员有效。
  2. 电脑(Mac 或 Windows)提前装好 Node.js(在终端输入 npx -v 能出版本号就行)。
  3. 电脑和鸿蒙手机连上 同一个 Wi-Fi。

第一步:生成一条专属客户端环境变量

在电脑终端运行这一行命令(或在浏览器打开 https://mcp.aoqi360.com/?client=cherry#connect 查看字段):

npx -y xiaobei-harmony-mcp config --client=cherry

命令会打印出四个固定环境变量,其中 XIAOBEI_MCP_INSTANCE_ID 是给你生成好的一串 UUID,先复制留着下一步用(以后一直固定用这一串,别每次自己换)。

第二步:在 Cherry Studio 设置里添加 STDIO MCP 服务

  1. 打开 Cherry Studio,点左下角 设置 -> MCP 服务器 -> 添加服务器。
  2. 服务名称填 xiaobei-harmony,类型选择 STDIO(标准输入输出 / 本地命令)。
  3. 依次填好下面这几栏:
    • 命令(Command):npx(Windows 如果报错找不到命令,改成 npx.cmd)
    • 参数(Arguments,每行一个):
      • -y
      • xiaobei-harmony-mcp
    • 环境变量(Environment Variables):
XIAOBEI_MCP_CLIENT_ID=cherry
XIAOBEI_MCP_INSTANCE_ID=填第一步为你生成的UUID
XIAOBEI_MCP_APP_ID=autoclicker
XIAOBEI_MCP_HUB_URL=https://api.aoqi360.com
  1. 保存并把 xiaobei-harmony 这条 MCP 服务的 总开关 打开,看到状态灯变绿说明本地进程已经拉起。

第三步:在当前对话助手中启用小贝工具

  1. 回到 Cherry Studio 聊天页面。
  2. 在正在使用的 助手 / 对话输入框工具栏 里点开 MCP 工具选择列表,勾上 xiaobei-harmony(一定要确认当前对话开启了工具调用,并且选的模型支持 Function / Tool Calling)。

第四步:扫码连接手机开始使用

  1. 在 Cherry Studio 聊天框发送:
用小贝检查一下手机连接。
  1. 电脑会自动打开配对二维码页面并显示 4 位配对码(10 分钟内有效)。
  2. 拿起鸿蒙手机打开 小贝自动点击器 -> AI 连接,扫码或者输入 4 位短码,核对名字是 Cherry Studio 后点 「允许连接」。
  3. 提示连接成功以后,你就可以直接让 Cherry Studio 看看手机屏幕、点对应文字按钮或翻页截图了。

注意事项

  • 如果中途切去用了 Cursor 或 CubeAgent,回小贝「AI 连接」里再点回 Cherry Studio 就能立刻切回控制权,不用重新填环境变量。
  • 涉及到付款密码、验证码等隐私页面,建议先在小贝暂停或关掉授权,避免屏幕内容发给你选用的外接大模型服务。

相关常见问题

我在 Cherry Studio 设置里加好了 MCP,为什么对话时它说没有这个工具?

加完全局 MCP 服务器以后,还需要进你正在聊天的那个助手(或输入框上方的工具按钮)里把「xiaobei-harmony」的开关打开,该会话才能真正调用它。

每次启动 Cherry Studio 都会新生成 XIAOBEI_MCP_INSTANCE_ID 吗?

只要你在环境变量输入框里填好第一次生成的那串 UUID,以后每次打开都会继续沿用它,不用反复扫码配对。

手机上画面会不会发到 Cherry Studio 之外的地方?

电脑和手机之间走同一 Wi-Fi 局域网点对点连接,云端不接收手机截图;之后 Cherry Studio 会按照常规工具结果机制把画面或页面结构传给你自己在模型配置里选择的模型端口。