witchan/ios-mcp

iOS MCP: MCP management tool for jailbroken iPhones, enabling developers and AI agents to inspect and control devices.

何を解決するか

iOS MCPは、AIエージェント(Claude、Cursor、Codexなど)がジャイルブレイクされたiPhoneを直接制御・操作できるようにします。LLMベースのエージェントと物理的なiOSデバイスの間のギャップを埋め、標準化されたプロトコルを通じて自動テスト、リバースエンジニアリング、デバイス管理を可能にします。

動作方法

このプロジェクトは、ジャイルブレイクされたiOSデバイス上で直接実行されるModel Context Protocol (MCP) サーバーを実装しています。AIエージェントがデバイス上で動作を実行できるように、46種類のツールを公開しています。これらのツールは以下の機能領域に分類されます:

  • タッチと入力: HIDシミュレーションまたはクリップボード経由で、正確な画面座標によるタップ、スワイプ、ドラッグ、テキスト入力をシミュレート。
  • システム制御: アプリの起動・終了・インストール・アンインストール、ハードウェアボタン(ホーム、電源、音量)の制御、明るさや音量などのシステム設定の調整。
  • 視覚とアクセシビリティ: スクリーンショットの取得、画面内のOCR、ターゲット操作に適したUI要素ツリーの取得。
  • システムアクセス: ファイルシステム、システムログ(syslog)、任意のコマンド実行用シェルへのアクセス。
  • デバイス情報: デバイス仕様、バッテリー状態、ジャイルブレイク状態の取得。

対象ユーザー

iOS 13~18をサポートするジャイルブレイクされたiOSデバイスを所有し、モバイルデバイスをAI駆動の自動化ワークフローに統合したい開発者、セキュリティ研究者、AIエージェント愛好家。

特徴

  • 包括的なツールセット: 基本的なタッチジェスチャーからシステムレベルのアクセスまでをカバーする46のツール。
  • クロスジャイルブレイク対応: ルートフル、ルートレス、ルートハイドのジャイルブレイクを含む、幅広いiOSバージョンで互換性あり。
  • アクセシビリティ統合: UI要素ツリーとOCRを使用して、エージェントが画面を「見る」かつ知的に操作できるように。
  • 制限付きのroot権限アクセス: パッケージ管理やシステム設定に必要な制限付きのroot権限昇格機能を提供。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト