mobile-mcp

让 AI 直接操作手机 App 的 MCP 工具

开源 🏷️定价信息待确认 ⏳ 访问状态待核验 自动化工作流 🍴 复刻 957 🐛 待处理 66 👀 关注 55
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 10688
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

mobile-mcp 项目界面预览图
图片来源:项目官网

项目数据

分类自动化工作流
开发团队mobile-next
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态⏳ 访问状态待核验
是否开源是
开源协议Apache-2.0
主要语言TypeScript
技术栈/模型agent,android,android-automation,appium-alternative,claude-code,codex,cursor,emulator,ios,ios-automation,mcp,mcp-server,mobile,mobile-automation,mobile-testing,real-device,simulator,skills
GitHub 星标★ 10688
上线时间2025-03-28 00:00:00
代码更新2026-11-18
仓库体积4.6 MB
本站数据更新2026-11-19
维护状态活跃
收录时间2026-11-19
浏览次数0

项目介绍

mobile-mcp 是一个基于 TypeScript 的 MCP 服务器,让 AI 代理直接操控 iOS 和 Android 应用。它面向移动端自动化测试与交互场景,把模拟器、仿真器和真机统一成一套可供 AI 调用的工具接口,支持 Claude Code、Codex、Cursor 等任意 MCP 客户端。核心能力包括:启动和关闭应用、点击滑动等手势操作、输入文本、截屏与读取界面元素结构,从而让大模型在真实移动环境中完成探索、回归验证和流程编排。相比 Appium 这类传统自动化框架,它省去了大量脚本编写,把设备操作抽象为模型可理解的原子动作,降低移动自动化的接入门槛,适合需要让 AI 直接操作 App 的开发者与测试团队。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-11-19 · 当前星标 ★ 10688

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 8 步

环境要求

  • 具备 Node.js / npx 运行环境(用于执行 npx 命令)
  • 一个支持 MCP 的客户端,如 Claude Code、Codex、Cursor、VS Code、Gemini CLI 等
  • 使用 iOS 仿真器时需要 Xcode,并先启动 Simulator
  • 使用 Android 模拟器时需要可用的 avdmanager / emulator 命令
  • 需要连接真实设备或模拟器/仿真器作为操作目标

安装与启动步骤

  1. 1安装到已检测客户端

    执行后自动识别本机已安装的 MCP 客户端,并让你选择为哪些客户端写入配置。

    npx @mobilenext/mobile-mcp@latest install
  2. 2全部客户端静默配置

    加上 --yes 参数后不再逐项询问,直接为所有检测到的客户端完成配置。

    npx @mobilenext/mobile-mcp@latest install --yes
  3. 3手动写入标准配置

    若客户端未被自动识别,可在其 MCP 配置文件的 mcpServers 下加入这段标准配置。

  4. 4Claude Code 添加服务

    不使用插件时,可在 Claude Code 中用 CLI 仅添加该 MCP 服务器。

    claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest
  5. 5Codex 添加服务

    用 Codex CLI 添加服务;也可改为编辑 ~/.codex/config.toml 写入对应配置。

    codex mcp add mobile-mcp npx "@mobilenext/mobile-mcp@latest"
  6. 6Gemini CLI 添加服务

    用 Gemini CLI 一条命令把 mobile-mcp 注册为可用的 MCP 服务器。

    gemini mcp add mobile-mcp npx -y @mobilenext/mobile-mcp@latest
  7. 7启动 iOS 仿真器

    先安装 Xcode 并启动 Simulator,再用 simctl 列出设备并引导指定机型。

    xcrun simctl list
    xcrun simctl boot "iPhone 16"
  8. 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 +···

★ 10559 2026-09-12
unsnooze 开源

限额一重置,AI 会话自动恢复,告别手动续命。

Automatically resume Claude Code, Codex CLI, Grok, Qwen Code, Kimi CLI, OpenCode, an···

★ 231 2026-08-09
lynq 开源

让数据库驱动K8s配置,自动执行工作流

⚓️ Kubernetes-Native Database-Driven Provisioning Workflow Automation

★ 78 2026-08-09
google-browser-scraper 开源

自托管抓 Google 搜索结果,输出 JSON 还能接 AI Agent

SERP Maven: self-hosted Google search scraper for Python and SERP API alternative. G···

★ 126 2026-11-02
puppeteer-render-text 开源

用 Chrome 引擎把文本变成高清图片,排版效果与浏览器一致。

Robust text renderer using headless chrome.

★ 65 2026-08-09
banco 开源

在终端里管项目,告别切来切去的 GUI

:file_folder: A project management tool for the command line

★ 58 2026-08-09
GURU-Ai 开源

在 Termux 里一键跑起 AI 助手,还能生成二维码分享

SIMPLE YET COMPLICATED

★ 1168 2026-08-09
Douyin_TikTok_Download_API 开源

一条命令部署,批量抓取三大平台无水印视频

自托管的抖音、TikTok、B 站数据采集与无水印视频下载 API,支持 AI agent 通过 MCP 调用与···

★ 21482 2026-10-23
hive 开源

一条命令开一个 AI 工作区,多任务并行不打架

Project/Worktree manager, deeply integrated with AI agents to increase productivity ···

★ 477 2026-10-06