Repolode
jfarcand

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. 1

    npx でサーバーをインストールします(macOS 15 以降と iPhone ミラーリングが必要です)

    npx -y mirroir-mcp install
  2. 2

    最初のスクリーンショット時に macOS のプロンプトが表示されたら、画面収録とアクセシビリティの権限を許可します

  3. 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 の数値は毎日更新されます。

関連プロジェクト