如何让 Cursor 操作你的纯血鸿蒙手机(MCP 接入教程)
用 Cursor 通过 xiaobei-harmony-mcp 在同一 Wi-Fi 下无线直连纯血鸿蒙真机,让 Cursor 看当前屏幕、检查 UI 控件并完成点击、滑动与输入。
快速步骤概览
- 确认电脑已安装 Node.js(可执行 npx),并与装有小贝的鸿蒙手机连在同一个 Wi-Fi 局域网。
- 在 Cursor 里发送自动配置口令,或运行 npx 命令将 xiaobei-harmony 写入 ~/.cursor/mcp.json。
- 在 Cursor 对话里说「用小贝检查一下手机连接」,用手机小贝扫弹出的二维码或输入 4 位配对码。
- 在手机端小贝「AI 连接」点允许连接后,就能在 Cursor 里直接查看真机屏幕和操作测试。
在电脑上用 Cursor 写鸿蒙应用或者调试手机流程时,配好小贝 MCP 之后,Cursor 就能在同一局域网里直接读取你纯血鸿蒙手机的页面结构、截当前屏幕图,还能帮你点按钮、滑列表和输入文字。
准备条件
- 手机装好 小贝自动点击器,已完成单机无线调试配对,处于登录且会员有效状态。
- 电脑(Mac 或 Windows)已装好 Node.js(终端里能正常运行
node -v和npx -v)。 - 电脑和鸿蒙手机连着 同一个 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。
扫码授权与首次测试
- 确认 Cursor 的 Settings 里能看到
xiaobei-harmony已启用(首次未配对时只会看到一个检查连接状态的工具xiaobei_get_connection_status)。 - 在 Cursor 对话框发送:
用小贝检查一下手机连接。
- 电脑浏览器会自动弹出配对二维码和 4 位短码(若没弹出可点对话框里给出的配对链接)。
- 打开手机上的 小贝自动点击器 -> AI 连接,扫码或输入 4 位短码,核对名称是
Cursor后点 「允许连接」。 - 等小贝连接完成,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 位码确认即可。