mobile-next/mobile-mcp
开发工具让 AI 代理通过统一接口操作 iOS 与 Android 模拟器、仿真器和真机应用的 MCP 服务器。
项目介绍
Mobile MCP 是一个 Model Context Protocol 服务器,给 AI 代理一套统一工具来操作移动应用。它覆盖 iOS 模拟器、iOS 真机、Android 仿真器和 Android 真机,代理不需要分别编写 XCUITest、Espresso 或平台适配代码。服务器以 MCP 工具形式提供设备列表、应用安装/启动/终止、点击、滑动、文本输入、硬件按键、深链、录屏、日志、崩溃报告和截图等功能 README。
交互优先读取原生无障碍树:代理可以按元素引用点击,截图和坐标点击只在需要时作为后备。这样返回的是结构化、可重复的结果,也不必每一步都消耗图片 token。适合用代理跑应用流程、填写表单或在连接设备上探索多步用户旅程的开发者和测试人员。
快速使用
需要 Node.js 20+、用于 iOS 的 Xcode 命令行工具、用于 Android 的 Android Platform Tools,以及支持 MCP 的客户端,例如 Claude Code、Codex、Cursor、Copilot 或 Gemini CLI 前置条件。先启动模拟器或仿真器,或连接已信任的真机。
快速安装命令会检测本机支持的 MCP 客户端并询问要配置哪些:
npx @mobilenext/mobile-mcp@latest install
加上 --yes 可以跳过询问,配置所有检测到的客户端 快速开始。手动配置时,在客户端的 MCP 配置中加入:
{
"mcpServers": {
"mobile-mcp": {
"command": "npx",
"args": ["-y", "@mobilenext/mobile-mcp@latest"]
}
}
}
然后让代理执行「列出可用设备」。如果返回正在运行的模拟器、仿真器和已连接设备,说明连接成功 验证。Claude Code、Codex、Cursor 等客户端的具体配置步骤见仓库的安装配置章节和 wiki。
运行模式与配置
默认使用 stdio 传输。要运行远程 Streamable HTTP 服务器,用 --listen 3000 启动,MCP 端点位于 /mcp,且为无状态模式 HTTP 模式。可通过 MOBILEMCP_AUTH 设置 Bearer token 保护请求。非标准 URL scheme 默认被拦截,可用 MOBILEMCP_ALLOW_UNSAFE_URLS 放行。默认开启 PostHog 与 Scarf 的匿名遥测,设置 MOBILEMCP_DISABLE_TELEMETRY=1 可关闭 环境变量。
无界面使用时,先启动 Android 仿真器,或用 xcrun simctl boot 启动 iOS 模拟器,再让 MCP 服务器连接 无界面模式。
使用约束
iOS 模拟器支持列在 macOS 和 Linux,Android 仿真器支持 Linux、Windows 和 macOS;真机需要正确的 USB 连接、信任授权或调试授权 平台支持。服务器在本机运行,只与连接的设备通信,托管云服务的数据收集范围见隐私政策 privacy。项目采用 Apache-2.0 许可证。Claude Code 的设备镜像功能需要支持 kitty graphics protocol 的终端,例如 kitty 或 Ghostty。
HotRepo 点评
从 README 看,这是一个有实际设备控制工具面的 MCP 服务器,而不只是托管产品的落地页;云真机选项和配套的 Mobilewright 测试框架与开源服务器并列存在。HotRepo 记录到该项目 2026-09-26 全语言日榜快照为 7,147 星,次日为 7,645 星,一天净增 573 星;项目没有记录过 GitHub 全语言日榜名次,因此站内信号只有这两个快照。这个跳升只能说明关注度,不是质量结论;对读者更实际的问题是,无障碍树方案是否适合自己应用的 UI 结构。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- jo-duchan/tapflow自托管的中继加 macOS 代理,把 iOS 模拟器和 Android 模拟器串流到浏览器,供团队做移动端测试。
- droidrun/mobilerun用自然语言驱动真实 Android 和 iOS 设备的 LLM 无关框架,可通过 CLI 或 Python API 完成点击、滑动、输入和多步任务。
- hridaya423/phonedriver让 AI 代理通过 MCP 和命令行读取并操控 Android 手机与 iPhone 屏幕,付款类操作前先向人确认。
- tester-army/e2e用自然语言指挥智能体操作 Web 与移动应用完成端到端测试,动作可录制并回放,适合需要覆盖多端的测试团队。
- phone-harness/mcp这是一个托管 MCP 服务,让 AI 智能体在云端操控真实 iPhone 和 Android 模拟器。