← 返回目录

Mobile MCP

社区

跨平台移动自动化与开发，支持iOS、Android、模拟器、仿真器及真机

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 362 / 438
Stars: ★ 9.0k 非常热门
传输方式: stdio（本地进程） · SSE
运行环境: Node.js 20+
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 今天
工具数: 23

39FMRS · D

该服务器为移动自动化提供了强大的集成，支持多平台和多种客户端。其无障碍优先的方法高效且避免视觉模型成本。然而，它是社区驱动项目，用户需自行承担风险。文档详尽，社区活跃。适合希望统一移动自动化的开发团队。

最强项 · 文档质量 12/20 最弱项 · 可靠性 3/20

可靠性

3/20

安全与权限

5/20

维护活跃度

8/20

文档质量

12/20

安装易用性

11/20

查看各项评分依据

可靠性 3/20: 依据：README 列出了 20+ 工具、npx 启动方式和 stdio/SSE 模式，manifest 指向 npm 包 @mobilenext/mobile-mcp；但未提供任何源码、CI 工作流或已提交测试，无法验证 MCP 初始化握手、工具列表与真实行为是否一致。server.json 中版本号为 {{VERSION}} 模板占位符，也未提供错误处理/边界条件证据。按“缺失证据即扣分”原则，不给信任分，得分低。
安全与权限 5/20: 依据：README 披露了默认启用 PostHog 匿名遥测（可用环境变量关闭）、SSE 认证使用 MOBILEMCP_AUTH，且危险 URL scheme 默认被阻止；未发现窃取凭据或真实 token 的安装示例，因此不触发红线。但设备控制工具可安装/卸载应用、输入文本、点击、录屏、打开 URL，未描述最小权限、确认机制或数据边界；遥测默认外发且无独立源码审计。扣分后给 5。
维护活跃度 8/20: 依据：仓库未归档，许可证为 Apache-2.0，README 提供贡献指南、行为准则、路线图和 Wiki；但未提供提交/发布历史、依赖更新记录、安全问题响应渠道或维护者响应证据。Stars 不作为加分项。因此给中低分 8。
文档质量 12/20: 依据：README 覆盖多客户端配置（Claude Code/Cursor/Copilot 等）、环境变量、工具列表、示例提示词、SSE/认证、前置条件和 Wiki 链接，结构清晰。但缺少每个工具的正式参数 schema（输入/输出）、错误码与故障排查细节、速率/成本/限制说明，也没有可供核验的日志示例。因此 12。
安装易用性 11/20: 依据：提供了标准 stdio npx 配置和多种主流客户端的安装片段，前置条件明确，SSE 模式也有启动命令。但无 CI/测试执行证据，静态校准要求此类场景 setup 最高不超过 15；且 iOS 真机需要 go-ios、WebDriverAgent 和隧道，步骤较多；manifest 版本为占位符。给 11。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络

适合谁

需要同时支持iOS和Android的开发者或测试团队，希望统一API
希望减少对XCUITest或Espresso等平台特定知识的依赖
需要结构化、确定性输出（基于无障碍树）而非仅依赖截图的场景
在本地或云上使用模拟器/仿真器进行自动化测试

不适合谁

需要视觉理解（如图像识别）或复杂图像验证的用例（该服务器主要基于无障碍树，仅在必要时使用截图）
不需要移动设备交互的通用桌面自动化
需要官方支持或企业级保障的团队（第三方开源项目）
无法满足前置条件（如Xcode、Android SDK、Node.js v20+）的环境

所需权限

需要访问本地文件系统以安装应用和保存截图/录像
需要网络访问以安装npm包和可能的云服务
对于真机，需要USB调试权限或go-ios/WebDriverAgent配置
SSE模式需要开放端口和可选认证令牌
可能发送匿名使用遥测数据（可通过环境变量禁用）

风险与副作用

自动操作移动设备可能导致误操作或数据丢失（如发送消息、购买）
提供的凭据（如邮箱）可能被存储或滥用
URL打开功能可能被用于打开非标准scheme（默认阻止，需显式允许）
SSE服务器未授权时可能被未经授权访问
依赖不稳定的第三方工具（如go-ios、WebDriverAgent）
遥测数据可能涉及敏感使用模式

安装接入

准备工作

运行环境：Node.js 20+

MOBILEMCP_AUTH 可选密钥为 SSE 服务器模式设置 Bearer 令牌；启用后所有请求需携带 Authorization: Bearer <token> 头。值由用户自行设定。

其他可选配置项（3 个）

MOBILEMCP_DISABLE_TELEMETRY 可选设为 1 可关闭通过 PostHog 收集的匿名使用遥测。

MOBILEMCP_ALLOW_UNSAFE_URLS 可选设为 1 可允许 mobile_open_url 打开非标准 URL scheme（默认被阻止）。

MOBILEMCP_LEGACY_ROBOT 可选设为 1 可对 Android 设备和物理 iOS 设备使用旧版平台专用驱动；iOS 模拟器仍使用 mobilecli。

使用npx运行服务器，支持stdio和SSE模式。SSE模式使用--listen参数，可选端口和主机绑定。可通过环境变量MOBILEMCP_AUTH设置Bearer token授权。适用于Claude Code、Codex、Gemini CLI、GitHub Copilot、Cursor、Windsurf等客户端。详细配置参见各客户端文档。

claude_desktop_config.json

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": ["-y", "@mobilenext/mobile-mcp@latest"]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "mobile-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mobilenext/mobile-mcp@latest"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

配置完成后，让 AI 助手“列出可用设备”；如果能返回正在运行的模拟器、仿真器或已连接的真机，说明服务器已正确连接。

常见排障

确保已安装Xcode命令行工具、Android平台工具和Node.js v20+
运行'mobile_list_available_devices'检查，若列表为空，确保模拟器/仿真器已启动
对于iOS真机，确保已安装go-ios、WebDriverAgent并建立隧道
检查环境变量（如MOBILEMCP_AUTH、MOBILEMCP_DISABLE_TELEMETRY）设置
若使用SSE模式，检查端口绑定和URL是否正确

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出当前可用的所有设备（模拟器、仿真器和真机）
启动设备上的设置应用，截图查看当前屏幕上有哪些元素
打开 https://example.com 并把屏幕方向切换为横屏
在设备上安装这个 APK 文件，然后启动它并开始录屏

工具能力 23

mobile_list_available_devices 只读

列出所有可用设备（模拟器、仿真器和真机）

mobile_get_screen_size 只读

获取移动设备屏幕的像素尺寸

mobile_get_orientation 只读

获取设备当前的屏幕方向

mobile_set_orientation 写入

更改屏幕方向（纵向/横向）

mobile_list_apps 只读

列出设备上所有已安装的应用

mobile_launch_app 写入

使用包名启动应用

mobile_terminate_app 写入

停止并终止正在运行的应用

mobile_install_app 写入

从文件（.apk、.ipa、.app、.zip）安装应用

展开其余 15 个工具

mobile_uninstall_app 破坏性

使用包名或bundle ID卸载应用

mobile_take_screenshot 只读

截取屏幕以了解当前屏幕内容

mobile_save_screenshot 写入

将截图保存到文件

mobile_list_elements_on_screen 只读

列出屏幕上的UI元素及其坐标和属性

mobile_click_on_screen_at_coordinates 写入

在指定的x,y坐标处点击

mobile_double_tap_on_screen 写入

在指定坐标处双击

mobile_long_press_on_screen_at_coordinates 写入

在指定坐标处长按

mobile_swipe_on_screen 写入

向任意方向滑动（上、下、左、右）

mobile_start_screen_recording 写入

开始录制设备屏幕到视频文件

mobile_stop_screen_recording 写入

停止当前的屏幕录制并保存视频

mobile_type_keys 写入

向聚焦元素输入文本，可选回车

mobile_press_button 写入

按下设备按钮（HOME、BACK、VOLUME_UP/DOWN、ENTER等）

mobile_open_url 写入

在设备浏览器中打开URL

mobile_list_crashes 只读

列出设备上的崩溃报告

mobile_get_crash 只读

按ID获取崩溃报告的完整内容

使用场景

iOS和Android原生应用自动化（测试或数据输入场景）

脚本化流程和表单交互，无需手动控制模拟器/仿真器或真机

由LLM驱动的多步骤用户旅程自动化

基于智能体的通用移动应用交互

智能体间通信，用于移动自动化用例和数据提取

支持客户端

Claude Desktop

Claude Code

Codex

Gemini CLI

GitHub Copilot

Cursor

Windsurf

Amp

Antigravity 2

Cline

Goose

Kiro

OpenCode

依据项目文档列出，未经本站实测。

详细介绍

这是一个Model Context Protocol（MCP）服务器，通过平台无关的接口实现可扩展的移动自动化与开发，无需分别掌握iOS或Android知识。可运行于模拟器（simulators）、仿真器（emulators）以及真机（iOS和Android）。本服务器允许智能体和大语言模型通过结构化的无障碍快照或基于坐标的点击与原生iOS/Android应用及设备交互。默认使用stdio传输，支持SSE模式（通过--listen参数）。