MCP 客户端接入

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

用 Cursor 通过 xiaobei-harmony-mcp 在同一 Wi-Fi 下无线直连纯血鸿蒙真机,让 Cursor 看当前屏幕、检查 UI 控件并完成点击、滑动与输入。

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

快速步骤概览

  1. 确认电脑已安装 Node.js(可执行 npx),并与装有小贝的鸿蒙手机连在同一个 Wi-Fi 局域网。
  2. 在 Cursor 里发送自动配置口令,或运行 npx 命令将 xiaobei-harmony 写入 ~/.cursor/mcp.json。
  3. 在 Cursor 对话里说「用小贝检查一下手机连接」,用手机小贝扫弹出的二维码或输入 4 位配对码。
  4. 在手机端小贝「AI 连接」点允许连接后,就能在 Cursor 里直接查看真机屏幕和操作测试。

在电脑上用 Cursor 写鸿蒙应用或者调试手机流程时,配好小贝 MCP 之后,Cursor 就能在同一局域网里直接读取你纯血鸿蒙手机的页面结构、截当前屏幕图,还能帮你点按钮、滑列表和输入文字。

准备条件

  1. 手机装好 小贝自动点击器,已完成单机无线调试配对,处于登录且会员有效状态。
  2. 电脑(Mac 或 Windows)已装好 Node.js(终端里能正常运行 node -v 和 npx -v)。
  3. 电脑和鸿蒙手机连着 同一个 Wi-Fi(如果公司 Wi-Fi 开了隔离互访,可以手机开热点让电脑连上调试)。

方法一:发一句话让 Cursor 自己写好配置(最快)

打开 https://mcp.aoqi360.com/?client=cursor#connect,或者直接把下面这句话发进 Cursor 的 Agent 对话框:

请阅读小贝接入教程:https://mcp.aoqi360.com/autoclicker/llms.txt,帮我在 "Cursor" 中连接小贝。

Cursor 会自动检查 ~/.cursor/mcp.json,只添加小贝一项配置而不会覆盖你原来的其他 MCP 服务。写好之后,按提示在手机小贝扫码确认即可。

方法二:用命令行一键写入或手动编辑 ~/.cursor/mcp.json

如果你想自己动手配置,在电脑终端运行这一条命令(只写小贝条目,保留已有服务):

npx -y xiaobei-harmony-mcp init --client=cursor

想手动核对或手写配置时,打开用户目录下的 ~/.cursor/mcp.json(或当前项目下的 .cursor/mcp.json),结构如下:

{
  "mcpServers": {
    "xiaobei-harmony": {
      "command": "npx",
      "args": ["-y", "xiaobei-harmony-mcp"],
      "env": {
        "XIAOBEI_MCP_CLIENT_ID": "cursor",
        "XIAOBEI_MCP_INSTANCE_ID": "这里填生成一次并固定保留的UUID",
        "XIAOBEI_MCP_APP_ID": "autoclicker",
        "XIAOBEI_MCP_HUB_URL": "https://api.aoqi360.com"
      }
    }
  }
}

Windows 用户如果遇到 npx 找不到命令,把 "command": "npx" 改成 "npx.cmd" 或填写 npx.cmd 的完整路径即可。XIAOBEI_MCP_INSTANCE_ID 可先运行 npx -y xiaobei-harmony-mcp config --client=cursor 生成一份现成的 UUID。

扫码授权与首次测试

  1. 确认 Cursor 的 Settings 里能看到 xiaobei-harmony 已启用(首次未配对时只会看到一个检查连接状态的工具 xiaobei_get_connection_status)。
  2. 在 Cursor 对话框发送:
用小贝检查一下手机连接。
  1. 电脑浏览器会自动弹出配对二维码和 4 位短码(若没弹出可点对话框里给出的配对链接)。
  2. 打开手机上的 小贝自动点击器 -> AI 连接,扫码或输入 4 位短码,核对名称是 Cursor 后点 「允许连接」。
  3. 等小贝连接完成,Cursor 就能自动拿到全套手机操作工具。你可以试着问它:看看我现在手机屏幕在哪个 App,帮我点一下搜索框。

平时多客户端切换与安全保护

  • 小贝支持同时保存 Cursor、Codex、CubeAgent 等多个已授权客户端,但同一时间只启用一个;切到别的客户端后,回手机「AI 连接」列表点一下切换就行,不用重新扫码。
  • 遇到账号登录、支付或验证码页面时,随时可以在小贝「AI 连接」关掉权限开关,或点悬浮小窗和实况通知栏立即停下来。

相关常见问题

Cursor 配好 MCP 之后手机屏幕会上传到外部服务器吗?

不会。小贝只走你电脑上的本地 MCP 进程(xiaobei-harmony-mcp)和同一 Wi-Fi 下的手机点对点通信,截图与 UI 节点信息不会经过公共云端中继。

配置里 XIAOBEI_MCP_INSTANCE_ID 可以每次随便改吗?

不要随便换。它用来标识你这台电脑上的 Cursor 实例,生成一次后固定保留在 mcp.json 里,以后重连都用同一个 UUID 就行,不需要每次重新扫码。

扫码页过期了怎么办?

配对二维码 10 分钟内有效。过期后不用重新改配置或删重装,直接在 Cursor 里再发一句「帮我继续连接小贝」,重新获取新的二维码和 4 位码确认即可。