📱
让 AI 直接操控你的手机
mobile-mcp：一个 MCP 服务器，iOS / Android 真机模拟器通吃
7600+ Star
Apache-2.0
一条 npx 接入
📖 它是什么
mobile-mcp 是一个开源的 MCP（Model Context Protocol）服务器。装上它，你的 Claude Code、Cursor、Codex、Gemini、Copilot 就能直接操控手机：点按钮、输文字、滑动、截图、录屏、装 App、读日志。
以前做移动端自动化，iOS 学 XCUITest，Android 学 Espresso，两套框架。它把这些全屏蔽，同一个 API 通吃 iOS 模拟器 / iOS 真机 / Android 模拟器 / Android 真机。
✨ 核心亮点
🚀
无障碍树优先
读原生 UI 树，不用视觉模型不烧 token
📱
一套 API 通吃
iOS / Android、模拟器 / 真机同一组工具
🧰
全设备控制
点击滑动、装卸载、录屏、按键、深链
🪞
设备镜像
Claude Code 侧栏实时看手机屏
🖥️ 环境要求
| Node.js | v20+ |
| iOS 测试 | Xcode 命令行工具 + Simulator |
| Android 测试 | Android SDK + adb + emulator 或真机 |
| AI 客户端 | Claude Code / Cursor / Codex / Gemini / Copilot 等 MCP 兼容客户端 |
🚀 三步上手
① 标准 MCP 配置（几乎所有客户端通用）
{
"mcpServers": {
"mobile-mcp": {
"command": "npx",
"args": ["-y", "@mobilenext/mobile-mcp@latest"]
}
}
}② 各客户端快捷命令
claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest
codex mcp add mobile-mcp npx "@mobilenext/mobile-mcp@latest"
gemini mcp add mobile-mcp npx -y @mobilenext/mobile-mcp@latest③ 启动模拟器 / 连真机，让 AI 列设备
list available devices能看到你的模拟器和真机就说明接好了。之后直接自然语言下指令：
"在 B 站搜一个拉面视频，点赞，留个评论'讲得真好'"
"打开 App Store，搜 1k+ 星的番茄钟 App，下载注册给五星好评"
"打开 ClassPass，订明早 7 点的瑜伽课，再设个闹钟"🧰 AI 能操控哪些动作
| 设备管理 | 列设备、屏幕尺寸、转屏、折叠屏、改 GPS、读剪贴板 |
| App 管理 | 列已装 App、启动 / 关闭 / 安装 / 卸载 |
| 屏幕交互 | 截图、列 UI 元素、点 / 双击 / 长按、滑动、录屏 |
| 输入导航 | 输文字、Home / Back / 音量键、打开 URL |
| 日志崩溃 | 抓 logcat / iOS 日志、列崩溃报告、批量命令一次跑多步 |
❓ 常见问题
Q：要写代码吗？
不用。装完 MCP 配置，直接自然语言让 AI 操作手机。
Q：iOS 和 Android 要分别学吗？
不用。同一组工具，AI 自动适配当前设备。
Q：烧 token 吗？
不烧。读原生无障碍树，不是每步截图喂视觉模型。
Q：没有真机怎么办？
iOS 用 Simulator（macOS），Android 用 emulator（Windows/macOS/Linux 都行）。
Q：支持哪些 AI 客户端？
Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot、Amp、Cline、Goose、Windsurf、Kiro、opencode、Antigravity——任何 MCP 兼容客户端。
📎 GitHub 搜索 mobile-next/mobile-mcp
关注「AI工具匠」，获取更多 AI 工具实操教程