Mobile MCP:让AI跨iOS与Android自动操作真机和模拟器
给AI客户端操作iOS和Android应用的MCP服务器,用可访问性树替代纯截图自动化。
GitHub mobile-next/mobile-mcp 更新 2026-09-27 分支 main 星标 7.4K 分叉 641
TypeScript MCP Server 移动自动化 iOS Android 模拟器与真机

🧭 决策指南

适合,如果你

  • 你要让Claude Code、Cursor或Codex执行跨iOS和Android的移动UI工作流。
    README 的“Works with Claude Code, Codex, Gemini, GitHub Copilot...”和“One API, every target”。
  • 你已有iOS Simulator或Android Emulator,希望在没有真机时运行移动自动化。
    README 的“Running in headless mode on Simulators/Emulators”章节说明可在后台运行模拟器或仿真器。
  • 你希望从原生accessibility tree读取UI,而不是让vision model处理完整截图。
    README 的“Accessibility-first — fast and cheap”明确写有“no vision model, no image tokens”。

不适合,如果你

  • 你的iOS环境没有Xcode,且不能启动Simulator。
    README 的“Running & configuration”写明iOS需要Xcode,并在使用前运行Simulator。
  • 你的目标应用无法提供可访问性元素,且流程不能接受截图坐标回退。
    README说明主路径是native accessibility tree,不可用时才回退到screenshots + coordinates。
  • 你需要材料中未说明的企业级Authorization、Telemetry或Streamable HTTP配置。
    这些章节仅被列为README省略章节,具体配置未提供。

前置条件

  • {'text': '需要MCP-compatible client;README列出Claude Code、Codex、Gemini、GitHub Copilot等。', 'text_en': 'An MCP-compatible client is required; the README lists Claude Code, Codex, Gemini, and GitHub Copilot.'}
  • {'text': '标准配置使用npx和@mobilenext/mobile-mcp@latest。', 'text_en': 'The standard configuration uses npx and @mobilenext/mobile-mcp@latest.'}
  • {'text': 'iOS模拟器需要Xcode,并在使用前运行Simulator。', 'text_en': 'The iOS simulator requires Xcode, and the Simulator must be running before use.'}
  • {'text': '无真机时可使用Android emulator或iOS simulator在后台运行。', 'text_en': 'Without a real device, an Android emulator or iOS simulator can run in the background.'}

第一步命令(README 原文)

xcrun simctl list

要注意

  • iOS模拟器名称和状态需先用xcrun simctl list确认,再执行boot命令。
    README在Running & configuration中依次列出xcrun simctl list和xcrun simctl boot "iPhone 16"。
  • 截图坐标只属于fallback路径,不能等同于结构化accessibility输出。
    README同时说明accessibility tree是主路径,screenshots + coordinates仅在需要时使用。
  • 使用@latest意味着配置示例跟随npm最新包,而项目最新发布版本是1.0.4。
    安装配置使用@mobilenext/mobile-mcp@latest,项目元数据列出最新版本Version 1.0.4。

替代方案

  • XCUITest:当团队明确需要iOS原生测试框架而不是MCP客户端驱动时,README将XCUITest列为Mobile MCP无需使用的原生方案。
    Main Features
  • Espresso:当团队明确需要Android原生测试框架而不是统一移动API时,README将Espresso列为Mobile MCP无需使用的方案。
    Main Features

材料未说明

  • README材料没有给出Node.js、npm、Xcode或Android SDK的最低版本。
  • README材料没有列出完整MCP工具名称、参数、返回结构和错误处理方式。
  • README材料没有说明iOS与Android各版本、设备型号及应用类型的支持边界。
  • README材料没有说明真实设备配对、权限、USB连接和云设备的具体配置。
  • README材料没有提供Mobile Next Cloud的价格、区域、延迟和数据处理细节。
  • README材料没有说明无障碍树不可用时的截图坐标识别规则与失败率。
  • README材料没有说明并发设备数量、吞吐量、稳定性指标或CI集成方式。
  • README材料没有展开Authorization、Telemetry、Environment variables和Streamable HTTP Server Mode。
  • README材料没有说明版本1.0.4相对前一版本的变更内容。

💡 深度解析

6
不适合 我用 Codex CLI 维护长期运行的 iOS/Android 回归流水线,要求高精度断言、并发设备编排、复杂测试夹具和稳定 CI 报告;我能否只用 Mobile MCP 替代 XCUITest、Espresso 或专业设备农场?
适合读者: 维护严格移动回归流水线的 QA 团队,使用 Codex CLI,需要高精度断言、并发设备编排、复杂测试夹具和长期稳定的 CI 报告

不适合只用 Mobile MCP 替代完整回归基础设施,因为项目洞察明确指出它不是完整替代 XCUITest、Espresso 或专业测试框架。

  • README 的价值重点是 Agent 可调用的移动控制层、结构化界面读取和自然语言工作流,而不是完整测试编排系统。
  • 项目洞察明确列出高精度断言、并发设备编排、复杂测试夹具和稳定 CI 报告仍可能需要专用工具配合。
  • 无障碍树缺失时会使用截图和坐标回退;坐标受分辨率、方向和布局影响,不适合作为所有严格回归步骤的唯一定位机制。
  • Mobile MCP 更适合作为 Agent 驱动的探索、验收和端到端验证层,与现有代码化测试并用。
  • 项目洞察 usage_limitations:不是完整替代 XCUITest、Espresso 或其他专业测试框架
  • 项目洞察 usage_limitations:高精度断言、并发设备编排、复杂测试夹具、性能测试和稳定 CI 测试报告仍可能需要专用工具
  • Main Features:结构化、确定性输出与截图坐标回退并存
  • 项目洞察 best_practices:在需要严格断言、并发执行或长期回归的部分保留传统自动化测试框架
codex mcp add mobile-mcp npx "@mobilenext/mobile-mcp@latest"
材料未说明:README 摘录未说明是否提供测试断言 API、JUnit/HTML 报告或 CI 插件。;未说明并发设备数量、测试隔离、重试策略和失败重放能力。;未说明 XCUITest/Espresso 与 Mobile MCP 的具体组合方式。
适合 我使用 Claude Code 验证原生 iOS/Android 应用的端到端流程,测试步骤包含深链接、安装和终止应用、旋转方向、硬件按钮以及录屏;Mobile MCP 是否能覆盖这些设备级动作?
适合读者: 使用 Claude Code 做移动端端到端验收的开发者,需要覆盖深链接、应用安装/终止、方向切换、硬件按钮和屏幕录制,而不是只做点击回归

适合,README 的 Full device control 已直接列出你要求的大部分设备级能力。

  • 功能列表包含 app install/launch/terminate,可覆盖应用生命周期准备和清理。
  • 同一列表包含 screen recording、hardware buttons、deep links 和 orientation,与你的验收步骤逐项对应。
  • 工具通过 MCP 暴露给 Claude Code,README 还提供了专用 CLI 注册命令,因此接入路径明确。
  • 但 README 摘录没有说明深链接在 iOS 与 Android 上的参数格式、录屏文件保存位置、硬件按钮支持清单,也没有说明如何把录屏与验收结果自动关联。
  • Main Features: “Full device control: taps, swipes, and gestures; app install/launch/terminate; screen recording; hardware buttons; deep links; orientation”
  • Claude Code 安装章节:Use the Claude Code CLI to add the Mobile MCP server
  • Available MCP Tools 章节已列出但正文摘录省略
claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest
材料未说明:README 摘录未提供 deep link、硬件按钮和录屏工具的具体参数。;未说明录屏、日志和崩溃报告的输出格式、保存位置及生命周期。
适合 我需要用 Claude Code 同时验证 iOS Simulator、Android Emulator 和物理真机,而且不想分别维护 XCUITest、Espresso 及平台胶水代码,Mobile MCP 是否适合?
适合读者: 维护原生 iOS 和 Android 应用、使用 Claude Code、同时覆盖模拟器与真机、且不想分别维护 XCUITest 和 Espresso 脚本的移动 QA 工程师

适合,因为它正是为跨 iOS、Android、模拟器、仿真器和真机提供统一 MCP 工具而设计的。

  • README 明确写出 “One API, every target”,同一套工具覆盖 iOS 和 Android 设备形态。
  • “No platform expertise required” 直接说明不需要 XCUITest、Espresso 或逐平台 glue code。
  • 工具不仅能读取原生界面,还支持点击、滑动、输入、应用安装/启动/终止、方向切换和硬件按钮。
  • 但跨设备结果仍取决于应用是否正确暴露 accessibility tree;自绘控件或无障碍属性缺失时会退回截图和坐标操作,稳定性可能下降。
  • Main Features: “One API, every target”
  • Main Features: “No platform expertise required: no XCUITest, no Espresso, no per-platform glue”
  • Main Features: “Full device control”
  • README 原句:通过 structured accessibility snapshots 或 coordinate-based taps based on screenshots
claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest
材料未说明:README 未给出不同 iOS/Android 版本及真机型号上的兼容矩阵。;README 未说明跨平台工作流的断言语法、并行设备数量或 CI 编排能力。
适合 我现在只有本机后台运行的 Android Emulator,使用 Codex CLI,想让 Agent 启动应用、读取结构化界面并填写表单;Mobile MCP 能否满足,应该从哪里开始?
适合读者: 使用 Codex CLI 的 Android 开发者,只能在本机后台运行 Android Emulator,并希望通过自然语言完成应用启动、界面读取和表单输入

适合,README 同时覆盖 Android Emulator、本地运行和结构化界面交互,与你的约束匹配。

  • “Accessibility-first” 表示优先从原生无障碍树读取元素,不依赖视觉模型或图像 token,适合 Agent 判断表单字段和页面状态。
  • “Full device control”包含应用启动、点击、文本输入、手势等操作。
  • Running in “headless” mode 章节说明没有真机时可以在后台运行 emulator,并要求先启动 emulator,再运行 Mobile MCP。
  • 需要注意,README 没有在摘录中给出 Android Emulator 的完整启动命令,也没有说明你的应用包名、权限弹窗和测试账号如何配置。
  • Main Features: “Accessibility-first — fast and cheap”
  • Main Features: “Full device control: taps, swipes, and gestures; app install/launch/terminate”
  • Running & configuration: “Running in ‘headless’ mode on Simulators/Emulators”
  • How to Use: “instruct your AI assistant to use the available tools”
codex mcp add mobile-mcp npx "@mobilenext/mobile-mcp@latest"
材料未说明:摘录未提供 Android Emulator 的 avdmanager/emulator 完整命令。;README 未说明表单断言、权限弹窗处理和登录凭据注入方式。
适合 我用 Cursor Agent 验收 iOS 和 Android 原生界面,希望结果优先来自 accessibility snapshot,而不是每次调用视觉模型;遇到自绘控件时又需要坐标回退,Mobile MCP 是否符合这个策略?
适合读者: 使用 Cursor Agent 做跨平台 UI 验收的移动 QA 工程师,要求优先使用结构化 accessibility snapshot,只有无障碍树无法表达时才接受截图坐标回退

适合,因为 README 明确采用“无障碍树优先、截图坐标兜底”的双路径,而不是把所有操作建立在视觉识别上。

  • Accessibility-first 功能说明直接写出不使用 vision model 和 image tokens,可降低截图识别成本。
  • 服务器通过 structured accessibility snapshots 读取原生 iOS/Android 应用界面,输出比单纯截图更适合 Agent 消费的结构化信息。
  • 当无障碍树无法满足需求时,README 支持基于截图的 coordinate-based taps,因此能覆盖部分自绘或非标准控件。
  • 代价是坐标回退依赖屏幕尺寸、方向和布局;README 也没有承诺不同设备配置下坐标流程完全稳定。
  • Main Features: “Accessibility-first — fast and cheap”
  • Introduction: “structured accessibility snapshots or coordinate-based taps based on screenshots”
  • Main Features: “Structured, deterministic output”
  • 项目洞察:无障碍树优先、截图坐标兜底
npx -y @mobilenext/mobile-mcp@latest
材料未说明:README 未说明 Cursor Agent 如何选择结构化定位与坐标定位,也未给出工具参数细节。;README 未列出自绘 Canvas、游戏界面或复杂手势的支持边界。
视情况 我使用 Gemini CLI,团队不想在每台开发机上配置 Xcode、Android SDK 和 USB 真机,但需要操作云端真实 iOS/Android 设备;Mobile MCP 是否适合这种部署方式?
适合读者: 使用 Gemini CLI 的自动化工程师,需要在没有本地 iOS/Android 设备准备的情况下调用云端真实设备,并复用同一套 MCP 工具完成应用验收

视情况:Mobile Next Cloud 可以减少本地设备准备,但是否适合仍取决于云设备授权、网络、成本和数据合规要求。

  • README 明确支持通过 Mobile Next Cloud 连接云端真实 iOS 和 Android 设备,并强调使用“same tools, no local setup”。
  • 本地与云端使用同一 MCP 工具接口,适合把 Gemini CLI 的工作流从本机设备迁移到远程设备。
  • 项目描述覆盖 real devices、simulators 和 emulators,说明设备形态范围较广。
  • 但摘录没有给出云端设备套餐、并发数、区域、延迟、上传应用方式或企业数据隔离细节;这些信息决定它能否满足团队部署约束。
  • Introduction: “run it against real iOS and Android devices in the cloud with Mobile Next Cloud — same tools, no local setup”
  • README 标题:iOS, Android, Simulator, Emulator, and Real Devices
  • Remote Devices (Mobile Next Cloud) 章节已列出但正文摘录省略
  • 项目描述:Model Context Protocol Server for Mobile Automation and Scraping
gemini mcp add mobile-mcp npx -y @mobilenext/mobile-mcp@latest
材料未说明:README 摘录未说明 Mobile Next Cloud 的价格、并发设备上限、可用区域和网络延迟。;未说明远程设备上的应用上传、签名、账号隔离、日志保留和隐私合规机制。

✨ 核心亮点

  • Accessibility tree优先,避免vision model和image tokens
  • 同一套API覆盖iOS、Android、模拟器和真机
  • 支持点击、手势、安装、录屏和deep links
  • 结构化accessibility快照减少截图自动化歧义
  • 社区已有7,351星,但仅10位贡献者和5个版本

🔧 工程化

  • MCP Server让Claude Code、Codex等客户端操作移动应用
  • Accessibility snapshot读取原生UI元素并提取结构化数据
  • 统一支持iOS、Android、Simulator、Emulator和真机
  • 设备控制覆盖安装、启动、终止、录屏、方向和硬件按钮

⚠️ 风险

  • 无原生可访问性节点时会回退到截图加坐标操作
  • iOS模拟器运行明确要求先安装Xcode并启动Simulator
  • README未提供完整Prerequisites与Platform Support内容
  • 真实设备、云设备与Authorization配置细节未在材料中展开

👥 适合谁?

  • 使用Claude Code、Cursor或Codex测试移动UI流程的团队
  • 需要一套API覆盖iOS与Android设备矩阵的自动化工程师
  • 已有Xcode Simulator或Android Emulator的移动开发者