mobile-mcp移动自动化指南：一套接口如何同时驱动iOS和Android
【免费下载链接】mobile-mcpModel Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)项目地址: https://gitcode.com/GitHub_Trending/mo/mobile-mcp
还在为同一条流程写两套脚本？iOS 用 XCUITest，Android 用 UiAutomator，光环境就折腾半天。mobile-mcp 是一个移动自动化 MCP 服务器，用统一的工具集同时操作 iOS 和 Android 的模拟器、仿真器与真机，你只需描述目标，由 AI 代理完成点击、滑动和填表。
mobile-mcp 是什么
mobile-mcp 基于 Model Context Protocol（MCP）协议，把工作端（Claude、Copilot 等任意 MCP 客户端）和手机连起来。它优先读取系统原生的无障碍树来定位 UI 元素，取不到时才回退到截图加坐标，比纯截图方案更快也更稳。适合想跑移动端自动化但没有 iOS/Android 平台经验的测试同学、开发者，以及用 AI 代理驱动真机的用户。
核心能力一览
| 能力 | 说明 |
|---|---|
| 无障碍优先 | 直接读原生无障碍树定位元素，无需视觉模型，省 token |
| 全设备支持 | iOS/Android 模拟器、仿真器、真机共用同一套工具 |
| 完整设备控制 | 点击、滑动、长按、按键、屏幕录制、GPS 定位覆盖、剪贴板 |
| 结构化输出 | 提取真实 UI 元素和坐标，结果确定、可断言 |
| 批量执行 | mobile_batch_commands一次调用串起多步操作 |
平台支持情况如下，四种目标全都能跑：
| 目标 | 前置条件 |
|---|---|
| iOS 模拟器 | Xcode + 已启动的模拟器 |
| iOS 真机 | USB 连接并信任 |
| Android 仿真器 | Android SDK + adb 可用 |
| Android 真机 | 开启 USB 调试并授权 |
5分钟装好并配置 mobile-mcp
环境只需 Node.js 20+，加一端的工具链（macOS 装 Xcode 命令行工具，Android 装 platform-tools）。
检查 Node 版本：
node --version直接运行服务器（不接客户端时可用于自测连通性）：
npx @mobilenext/mobile-mcp@latest在支持 MCP 的 IDE 或 AI 助手里加入这段配置，重启后设备工具即可被代理调用：
{ "mcpServers": { "mobile-mcp": { "command": "npx", "args": ["-y", "@mobilenext/mobile-mcp@latest"] } } }更多客户端的配置变体可以查 README.md 里的 Installation 一节。
三个可以直接抄的场景
场景一：新应用注册流程冒烟测试。对代理说：打开目标应用，进入注册页，依次填写手机号与验证码，提交后确认进入首页，若某一步失败就截图并列出当前屏幕元素。每一步都会重新读取无障碍树验证结果，不会盲点。
场景二：iOS/Android 双端数据同步验证。在 iOS 设备创建一条待办，切到 Android 设备打开同一应用检查列表，再改状态回 iOS 复核。两台设备用同一组工具驱动，脚本零修改。
场景三：批量抓屏幕上的结构化数据。让代理遍历商品列表：滑动到底，逐屏读取元素文本和价格字段，汇总成表格。输出是真实 UI 节点而非 OCR 结果，基本不用人工清洗。
工具的使用惯例（先列设备、再读屏幕、操作后复核）可参考仓库自带的 skills/mobile-automation/SKILL.md。
你可能遇到的问题
没有真机能玩吗？能。两端模拟器/仿真器完全够用，先跑通流程再上真机。
同时接多台设备会冲突吗？不会。每次调用显式指定设备 ID，跨设备协同是官方支持的用法。
无障碍树读不到怎么办？会回退到截图加坐标，游戏、Canvas 绘制界面属于这种情况，可用mobile_take_screenshot确认。
支持哪些 AI 客户端？任何 MCP 客户端都行，Claude Code、Codex、Gemini、Copilot 都验证过。
怎么排查设备连不上？Android 先跑adb devices确认授权，iOS 确认模拟器已启动或真机已配对，具体见 README.md 的 Prerequisites。
装好配置后，从"列出设备并截一张图"这样的最小任务开始试起；完整的工具列表和调试说明见 README.md，动手比看文档更快。
【免费下载链接】mobile-mcpModel Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)项目地址: https://gitcode.com/GitHub_Trending/mo/mobile-mcp
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
