项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-19 · 当前星标 ★ 10688
使用教程
环境要求
- 具备 Node.js / npx 运行环境(用于执行 npx 命令)
- 一个支持 MCP 的客户端,如 Claude Code、Codex、Cursor、VS Code、Gemini CLI 等
- 使用 iOS 仿真器时需要 Xcode,并先启动 Simulator
- 使用 Android 模拟器时需要可用的 avdmanager / emulator 命令
- 需要连接真实设备或模拟器/仿真器作为操作目标
安装与启动步骤
-
1安装到已检测客户端
执行后自动识别本机已安装的 MCP 客户端,并让你选择为哪些客户端写入配置。
npx @mobilenext/mobile-mcp@latest install -
2全部客户端静默配置
加上 --yes 参数后不再逐项询问,直接为所有检测到的客户端完成配置。
npx @mobilenext/mobile-mcp@latest install --yes -
3手动写入标准配置
若客户端未被自动识别,可在其 MCP 配置文件的 mcpServers 下加入这段标准配置。
-
4Claude Code 添加服务
不使用插件时,可在 Claude Code 中用 CLI 仅添加该 MCP 服务器。
claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest -
5Codex 添加服务
用 Codex CLI 添加服务;也可改为编辑 ~/.codex/config.toml 写入对应配置。
codex mcp add mobile-mcp npx "@mobilenext/mobile-mcp@latest" -
6Gemini CLI 添加服务
用 Gemini CLI 一条命令把 mobile-mcp 注册为可用的 MCP 服务器。
gemini mcp add mobile-mcp npx -y @mobilenext/mobile-mcp@latest -
7启动 iOS 仿真器
先安装 Xcode 并启动 Simulator,再用 simctl 列出设备并引导指定机型。
xcrun simctl list xcrun simctl boot "iPhone 16" -
8启动 Android 模拟器
没有真机时,先用 avdmanager / emulator 命令启动一个模拟器实例,再让 MCP 操作它。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
mcpServers.mobile-mcp.command | 是 | 启动 MCP 服务器所用的可执行程序,标准配置中为 npx。 | npx |
mcpServers.mobile-mcp.args | 是 | 传给 npx 的参数,-y 表示跳过确认并直接运行指定包。 | ["-y", "@mobilenext/mobile-mcp@latest"] |
mcp_servers.mobile-mcp(Codex) | 否 | Codex 使用 TOML 配置,在 ~/.codex/config.toml 中声明命令与参数。 | command = "npx"
args = ["@mobilenext/mobile-mcp@latest"] |
~/.gemini/config/mcp_config.json | 否 | Antigravity 无 CLI 添加命令,需手动编辑该文件写入标准配置。 | /your/home/.gemini/config/mcp_config.json |
如何确认成功
在 MCP 客户端中能看到 mobile-mcp 及其工具,并成功执行一次截屏或读取界面元素的操作。
常见问题
Q:没有真机可以测试吗?
A:可以。没有真机连接时,可用 Android 模拟器或 iOS 仿真器在后台运行,MCP 会把这些实例当作操作目标。
Q:支持哪些 AI 客户端?
A:README 列出了 Claude Code、Codex、Cursor、VS Code、Gemini CLI、Amp、Cline、Copilot、Goose、Kiro、opencode、Windsurf、Antigravity 等,任何兼容 MCP 的客户端都可用。
Q:一键安装会改动哪些配置?
A:它会检测本机已安装的 MCP 客户端并让你挑选要配置的客户端;加 --yes 则不为每个客户端询问,直接全部配置。
Q:iOS 仿真器为什么连不上?
A:需要先安装 Xcode 并启动 Simulator,可用 xcrun simctl list 查看设备、xcrun simctl boot 引导指定机型后再使用。
Q:Cursor 里怎么手动添加?
A:进入 Cursor Settings → MCP → Add new MCP Server,类型选 command,命令填 npx -y @mobilenext/mobile-mcp@latest。
注意事项
- 所有命令中的 @latest 会拉取最新发布版本,如需固定版本可自行替换版本号。
- 运行 npx 前请确保本机已安装 Node.js,否则 npx 命令不可用。
- 每个客户端只需配置一次,重复执行安装命令会覆盖或新增同一份 MCP 配置。
- 设备侧操作(点击、输入、截屏)依赖已连接的模拟器、仿真器或真机,配置完成后先确认设备在线再让 AI 调用工具。
核心亮点
- 把点击、滑动、输入、截屏等设备操作封装成 MCP 工具,AI 客户端接入即用,无需手写 Appium 脚本
- 同时覆盖 iOS 模拟器、Android 仿真器和真机,一套接口跨平台调用
- 基于 TypeScript 实现,与 Claude Code、Cursor 等主流 MCP 客户端兼容性好
不足之处
- 依赖各平台原生工具链与设备连接环境,首次配置门槛不低
- 复杂手势与多设备并行场景的覆盖度仍需完善
- 文档/社区待观察
适用场景
- 让 AI 代理自动走查 App 核心流程并截图记录
- 移动端 UI 回归验证中由模型自主完成点击与输入
- 快速搭建跨 iOS/Android 的自动化演示与原型验证
替代项目
Appium、Maestro、Detox
上一篇:Windows-MCP
下一篇:mdldm-maitian
同类项目推荐
BrowserSkill
开源
让 AI 直接操作你已登录的真实浏览器,不打断当前工作
Let AI agents use your real, logged-in browser without interrupting your work. CLI +···
unsnooze
开源
限额一重置,AI 会话自动恢复,告别手动续命。
Automatically resume Claude Code, Codex CLI, Grok, Qwen Code, Kimi CLI, OpenCode, an···
lynq
开源
让数据库驱动K8s配置,自动执行工作流
⚓️ Kubernetes-Native Database-Driven Provisioning Workflow Automation
google-browser-scraper
开源
自托管抓 Google 搜索结果,输出 JSON 还能接 AI Agent
SERP Maven: self-hosted Google search scraper for Python and SERP API alternative. G···
puppeteer-render-text
开源
用 Chrome 引擎把文本变成高清图片,排版效果与浏览器一致。
Robust text renderer using headless chrome.
banco
开源
在终端里管项目,告别切来切去的 GUI
:file_folder: A project management tool for the command line
GURU-Ai
开源
在 Termux 里一键跑起 AI 助手,还能生成二维码分享
SIMPLE YET COMPLICATED
Douyin_TikTok_Download_API
开源
一条命令部署,批量抓取三大平台无水印视频
自托管的抖音、TikTok、B 站数据采集与无水印视频下载 API,支持 AI agent 通过 MCP 调用与···
hive
开源
一条命令开一个 AI 工作区,多任务并行不打架
Project/Worktree manager, deeply integrated with AI agents to increase productivity ···
