这个项目能做什么

Mobile MCP 是一个用于移动开发和自动化的 Model Context Protocol (MCP) 服务器。它提供平台无关的接口,使智能体和 LLM 无需分别掌握 iOS 或 Android 专业知识即可与原生 iOS 和 Android 应用交互。它可与 Claude Code、Codex、Gemini、GitHub Copilot 和 Antigravity 等兼容 MCP 的客户端配合使用,并可面向本地机器上的设备,或通过托管云服务面向远程设备。 支持的目标包括 iOS 模拟器(通过 Xcode 和 xcrun simctl)、通过 USB 连接的 iOS 真实设备、Android 模拟器(通过 adb),以及启用 USB 调试的 Android 真实设备。该服务器以 npm 包形式分发,通常通过 npx 启动,可基于 stdio,也可使用 --listen 标志作为 Streamable HTTP 服务器运行。HTTP 模式可通过环境变量要求可选的 Bearer token。 工具集涵盖设备管理(列出设备、屏幕尺寸、获取/设置方向、GPS 位置覆盖、剪贴板读取/替换)、应用管理(列出、前台应用、启动、终止、安装、卸载)、屏幕交互(截图、保存截图、列出带坐标的 UI 元素、点击、双击、长按、滑动、屏幕录制)、输入与导航(输入文本、硬件按钮、打开 URL),以及日志和崩溃报告(设备日志、崩溃列表和获取)。批处理命令工具可在一次调用中按顺序运行多个工具。远程设备工具允许登录云提供商、列出、分配和释放云设备。 该项目强调无障碍优先的方法:它通过原生无障碍树驱动应用,而不是视觉模型,并在需要时回退到截图和坐标;README 称这比仅使用截图的方法更快、更便宜。输出被描述为结构化且确定性的。 先决条件包括 Xcode 命令行工具、Android 平台工具、Node.js v20 或更高版本,以及支持 MCP 的智能体或模型。为许多客户端提供了配置示例,包括 Amp、Antigravity、Cline、Claude Code、Claude Desktop、Codex、Copilot、Cursor、Gemini CLI、Goose、Kiro、opencode 和 Windsurf。环境变量控制身份验证、遥测退出、不安全 URL scheme 和旧版 robot 模式。默认收集匿名遥测,可将其禁用。 该仓库还指向相关项目:用于可重复确定性移动测试的 mobilewright、作为底层设备 CLI 的 mobilecli,以及用于按需真实设备的云服务。文档、路线图、贡献指南和行为准则均有链接。README 指出,该服务器在本地运行,仅与已连接的设备通信,并另有隐私政策说明数据收集细节。