mobile-next/mobile-mcp

Mobile MCP 是一个模型上下文协议（MCP）服务器，将基于 LLM 的代理（Claude Code、Gemini、Cursor 等）与移动设备——iOS 模拟器、Android 仿真器以及真实手机/平板电脑——连接起来。它为代理提供了一个单一、平台无关的工具包，用于检查、点击、输入、滑动、安装应用、读取日志，并在任何连接的设备上自动化多步骤工作流。

该服务器采用无障碍优先的工作方式：它读取原生无障碍树（带有坐标和属性的 UI 元素），而不是依赖截图和视觉模型，这使其快速且成本低廉。在需要时，它会回退到截图 + 基于坐标的点击。它提供了约 30 个 MCP 工具，分为设备管理、应用控制、屏幕交互、输入/导航和日志/崩溃报告。

主要功能：

• 统一 API – 相同的工具适用于 iOS 和 Android、模拟器、仿真器和物理设备（使用 xcrun simctl / adb）。
• 完整的设备控制 – 点击、滑动、手势、应用安装/启动/终止、屏幕录制、硬件按钮、深层链接、剪贴板、方向、GPS 覆盖。
• 结构化输出 – 返回真实的 UI 元素数据，减少仅依赖截图的模糊性。
• 远程云设备 – 可以登录 Mobile Next Cloud 以预留物理设备进行扩展。
• 实时设备镜像 – 在支持 kitty 图形（Ghostty/kitty）的 Claude Code 终端中，/mobile-mirror 显示设备屏幕的实时侧边栏；用户可以点击、输入，并按 Home/Back 键。
• 可流式 HTTP 模式 – 可以作为无状态 HTTP 服务器运行（--listen 标志）用于云部署，并支持可选的 Bearer 令牌认证。

典型用法：代理收到自然语言请求——例如“找一个拉面视频，点赞、评论，并通过 WhatsApp 分享”——然后在连接的设备上逐步执行，读取屏幕状态并响应 UI 变化。

设置很简单：通过 npx 安装，并将标准 MCP 配置块添加到任何兼容 MCP 的客户端。预构建配置已记录在 Claude Desktop、Codex、Cursor、Gemini、Copilot 等中。