MCP経由でAIエージェントがUSBまたはWi-Fi接続の実機iPhoneを操作できるツールです。
jfarcand/mirroir-mcp
Developer Mode、Xcode、WebDriverAgentなしで、macOSのiPhoneミラーリングを通じて通常のiPhoneを任意のAIエージェントから操作できるMCPサーバー。
- スター
- 281
- フォーク
- 38
- 未解決の Issue
- 3
- 最終コミット
- 12 時間前
これは何?
mirroir-mcpは、AppleのiPhoneミラーリング機能を通じて、未改造の実機iPhoneを操作するmacOS向けMCPサーバーです。AIクライアントはOCRや画像認識で画面を確認し、タップ、スワイプ、文字入力、システムキーの押下を行えます。iPhone本体の画面を操作するため、ユーザー自身ではビルドや計測ができないApp Storeアプリにもアクセスできます。
基本的な操作ループに加え、ナビゲーション、スクロール、アプリのライフサイクルを扱う高レベルのツールも備えています。エージェントはアプリを幅優先で探索し、SKILL.mdのワークフローを生成できます。スキルは`mirroir test` CLIでコンパイルしておけば、LLMを使わずにリプレイでき、JUnit形式の出力と、CIで使える独立したドリフト判定も得られます。
また、iPhoneの操作手順にWeb(Playwright)、HTTP、サブプロセスの手順を組み合わせて1つのシナリオで実行する、Rust製ランナー`mirroir-run`も含まれています。iOSの実行にはiPhoneミラーリングを接続したMacが必要ですが、その他の対象はLinux上で実行できます。
主な機能
- 01iPhoneミラーリングを通じて、通常のiPhoneをタップ、スワイプ、文字入力、キー入力で操作します。
- 02Apple Vision OCR、オプションのYOLOアイコン検出、またはAI画像認識モードで画面を読み取ります。
- 03あらゆるMCPクライアントで利用でき、38個のツールを公開します。
- 04アプリを探索し、リプレイ可能なSKILL.mdスキルを生成します。
- 05コンパイル済みスキルをCLIからLLMなしでリプレイし、JUnit形式で結果を出力します。
- 06デフォルトでは安全側に倒して動作し、権限設定とブロック対象アプリのリストを利用できます。
ユースケース
- 計測できないApp Storeアプリのエンドツーエンドのスモークテストを実行する。
- AIアシスタントにメッセージの送信やカレンダーの予定作成など、日常的なスマートフォン操作を任せる。
- 手動の操作手順を記録し、CIシナリオとしてリプレイする。
- iPhoneのチェックとWebページのチェックを1つのクロスサーフェステストにまとめる。
クイックスタート
- 1
npx でサーバーをインストールします(macOS 15 以降と iPhone ミラーリングが必要です)
npx -y mirroir-mcp install - 2
最初のスクリーンショット時に macOS のプロンプトが表示されたら、画面収録とアクセシビリティの権限を許可します
- 3
mirroir を Claude Code の MCP サーバーとして登録します
claude mcp add --transport stdio mirroir -- npx -y mirroir-mcp
使う前に知っておきたいこと
- macOS 15 以降と iPhone ミラーリングでのみ動作します。Android と iOS Simulator には対応していません。
- iPhone ミラーリングではポインターが1つしか使えないため、素早い操作やマルチタッチ操作が必要なゲームには対応できません。
収録されている特集
トピック
よくある質問
- mirroir-mcp とは?
- Developer Mode、Xcode、WebDriverAgentなしで、macOSのiPhoneミラーリングを通じて通常のiPhoneを任意のAIエージェントから操作できるMCPサーバー。 mirroir-mcpは、AppleのiPhoneミラーリング機能を通じて、未改造の実機iPhoneを操作するmacOS向けMCPサーバーです。AIクライアントはOCRや画像認識で画面を確認し、タップ、スワイプ、文字入力、システムキーの押下を行えます。iPhone本体の画面を操作するため、ユーザー自身ではビルドや計測ができないApp Storeアプリにもアクセスできます。
- mirroir-mcp は無料で使えますか?ライセンスは?
- mirroir-mcp は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- mirroir-mcp は今もメンテナンスされていますか?
- 活発にメンテナンス中。mirroir-mcp の最終コミットは 2026年11月6日 です。
- mirroir-mcp は何に使えますか?
- 計測できないApp Storeアプリのエンドツーエンドのスモークテストを実行する。 AIアシスタントにメッセージの送信やカレンダーの予定作成など、日常的なスマートフォン操作を任せる。 手動の操作手順を記録し、CIシナリオとしてリプレイする。 iPhoneのチェックとWebページのチェックを1つのクロスサーフェステストにまとめる。
- mirroir-mcp のインストール方法は?
- npx でサーバーをインストールします(macOS 15 以降と iPhone ミラーリングが必要です): npx -y mirroir-mcp install 最初のスクリーンショット時に macOS のプロンプトが表示されたら、画面収録とアクセシビリティの権限を許可します mirroir を Claude Code の MCP サーバーとして登録します: claude mcp add --transport stdio mirroir -- npx -y mirroir-mcp
- mirroir-mcp はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/jfarcand/mirroir-mcp
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
AIエージェントがmacOS、Linux、Windowsのデスクトップを操作できる、MCPサーバーとして公開されたオープンソースのComputer Useサービス。
AIコーディングアシスタントやテストスイート向けの自然言語によるAndroid自動化。実機とエミュレーターで動作します。
Gherkinのfeatureファイルから、ブラウザー、API、セキュリティ、アクセシビリティ、ビジュアルのE2Eテストを自動生成・実行するオープンソースのAIテストエージェント。
MCPツールでAIエージェントが操作できるmacOS仮想マシン。Kitty、Ghostty、iTerm2のグラフィックスでターミナルに画面を表示します。
Codexの認証なしで、macOSとLinux上のあらゆるエージェントハーネスからCodexのcomputer-useランタイムを利用できます。