适合谁
- 需要同时支持iOS和Android的开发者或测试团队，希望统一API
- 希望减少对XCUITest或Espresso等平台特定知识的依赖
- 需要结构化、确定性输出（基于无障碍树）而非仅依赖截图的场景
- 在本地或云上使用模拟器/仿真器进行自动化测试
M
39FMRS · D
该服务器为移动自动化提供了强大的集成，支持多平台和多种客户端。其无障碍优先的方法高效且避免视觉模型成本。然而，它是社区驱动项目，用户需自行承担风险。文档详尽，社区活跃。适合希望统一移动自动化的开发团队。
这是一个Model Context Protocol（MCP）服务器，通过平台无关的接口实现可扩展的移动自动化与开发，无需分别掌握iOS或Android知识。可运行于模拟器（simulators）、仿真器（emulators）以及真机（iOS和Android）。本服务器允许智能体和大语言模型通过结构化的无障碍快照或基于坐标的点击与原生iOS/Android应用及设备交互。默认使用stdio传输，支持SSE模式（通过--listen参数）。
工具能力
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）安装应用
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获取崩溃报告的完整内容
安装接入
使用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"]
}
}
}
选型与风险
不适合谁
- 需要视觉理解（如图像识别）或复杂图像验证的用例（该服务器主要基于无障碍树，仅在必要时使用截图）
- 不需要移动设备交互的通用桌面自动化
- 需要官方支持或企业级保障的团队（第三方开源项目）
- 无法满足前置条件（如Xcode、Android SDK、Node.js v20+）的环境
所需权限
- 需要访问本地文件系统以安装应用和保存截图/录像
- 需要网络访问以安装npm包和可能的云服务
- 对于真机，需要USB调试权限或go-ios/WebDriverAgent配置
- SSE模式需要开放端口和可选认证令牌
- 可能发送匿名使用遥测数据（可通过环境变量禁用）
风险与副作用
- 自动操作移动设备可能导致误操作或数据丢失（如发送消息、购买）
- 提供的凭据（如邮箱）可能被存储或滥用
- URL打开功能可能被用于打开非标准scheme（默认阻止，需显式允许）
- SSE服务器未授权时可能被未经授权访问
- 依赖不稳定的第三方工具（如go-ios、WebDriverAgent）
- 遥测数据可能涉及敏感使用模式
常见排障
- 确保已安装Xcode命令行工具、Android平台工具和Node.js v20+
- 运行'mobile_list_available_devices'检查，若列表为空，确保模拟器/仿真器已启动
- 对于iOS真机，确保已安装go-ios、WebDriverAgent并建立隧道
- 检查环境变量（如MOBILEMCP_AUTH、MOBILEMCP_DISABLE_TELEMETRY）设置
- 若使用SSE模式，检查端口绑定和URL是否正确
使用场景
iOS和Android原生应用自动化（测试或数据输入场景）
脚本化流程和表单交互，无需手动控制模拟器/仿真器或真机
由LLM驱动的多步骤用户旅程自动化
基于智能体的通用移动应用交互
智能体间通信，用于移动自动化用例和数据提取
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Codex完整支持
Gemini CLI完整支持
GitHub Copilot完整支持
Cursor完整支持
Windsurf完整支持
Amp完整支持
Antigravity 2完整支持
Cline完整支持
Goose完整支持
Kiro完整支持
opencode完整支持