jfarcand/mirroir-mcp

这是什么？

核心功能

• 01通过 iPhone 镜像对普通 iPhone 进行点击、滑动、输入文字和按键操作。
• 02支持 Apple Vision OCR、可选的 YOLO 图标识别以及 AI 视觉模式读取屏幕。
• 03兼容任意 MCP 客户端，提供 38 个工具。
• 04可自动探索应用并生成可回放的 SKILL.md 技能文件。
• 05编译后的技能可通过命令行在无需大模型的情况下回放，并输出 JUnit 报告。
• 06默认采用失败即拒绝的策略，支持权限配置和应用黑名单。

适用场景

• 对无法植入测试代码的 App Store 应用进行端到端冒烟测试。
• 让 AI 助手代为完成发消息、建日历事件等日常手机操作。
• 录制一次手动操作流程，并将其作为 CI 场景回放。
• 在同一个测试中同时校验 iPhone 与网页的显示内容是否一致。

快速上手

1. 1

   通过 npx 安装服务器（需要 macOS 15+ 并已连接 iPhone 镜像）

   npx -y mirroir-mcp install
2. 2

   首次截图时，在 macOS 提示时授予屏幕录制和辅助功能权限

3. 3

   在 Claude Code 中将 mirroir 注册为 MCP 服务器

   claude mcp add --transport stdio mirroir -- npx -y mirroir-mcp

使用前须知

• !仅适用于 macOS 15+ 并使用 iPhone 镜像功能；不支持 Android 或 iOS 模拟器。
• !由于 iPhone 镜像只提供单一指针，需要快速反应或多点触控的游戏无法使用。

收录于专题

标签

常见问题

mirroir-mcp 是什么？

让任意 AI 智能体通过 macOS iPhone 镜像控制一台普通 iPhone，无需开发者模式、Xcode 或 WebDriverAgent。 mirroir-mcp 是一个运行在 macOS 上的 MCP 服务器，通过苹果的 iPhone 镜像功能控制一台未经修改的真实 iPhone。AI 客户端可以用 OCR 或视觉识别读取屏幕，然后执行点击、滑动、输入文字和系统按键。由于直接作用于手机屏幕，它可以操作开发者无法自行构建或植入代码的 App Store 应用。

mirroir-mcp 可以免费使用吗？用的什么许可证？

mirroir-mcp 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

mirroir-mcp 还在维护吗？

活跃维护中。mirroir-mcp 最近一次提交是在 2026年11月6日。

mirroir-mcp 适合用来做什么？

对无法植入测试代码的 App Store 应用进行端到端冒烟测试。 让 AI 助手代为完成发消息、建日历事件等日常手机操作。 录制一次手动操作流程，并将其作为 CI 场景回放。 在同一个测试中同时校验 iPhone 与网页的显示内容是否一致。

mirroir-mcp 怎么安装和运行？

通过 npx 安装服务器（需要 macOS 15+ 并已连接 iPhone 镜像）: npx -y mirroir-mcp install 首次截图时，在 macOS 提示时授予屏幕录制和辅助功能权限 在 Claude Code 中将 mirroir 注册为 MCP 服务器: claude mcp add --transport stdio mirroir -- npx -y mirroir-mcp

在哪里获取 mirroir-mcp？

源代码和安装说明在 GitHub 上：https://github.com/jfarcand/mirroir-mcp