このプロジェクトについて

Mobile MCPは、モバイル開発と自動化のためのModel Context Protocol（MCP）サーバーです。プラットフォーム非依存のインターフェースを公開することで、エージェントやLLMが個別のiOSやAndroidの専門知識を必要とせずに、ネイティブのiOSおよびAndroidアプリケーションと対話できるようにします。Claude Code、Codex、Gemini、GitHub Copilot、AntigravityなどのMCP互換クライアントで動作し、ローカルマシン上のデバイス、またはホスト型クラウドサービスを通じたリモートデバイスを対象にできます。 サポートされる対象には、iOSシミュレータ（Xcodeおよびxcrun simctl経由）、USB接続されたiOS実機、Androidエミュレータ（adb経由）、USBデバッグが有効なAndroid実機が含まれます。このサーバーはnpmパッケージとして配布され、通常はnpxで起動され、stdio経由または--listenフラグを使用したStreamable HTTPサーバーとして動作します。HTTPモードでは、環境変数を通じてオプションのBearerトークンを要求できます。 ツールセットは、デバイス管理（デバイス一覧、画面サイズ、画面の向きの取得/設定、GPS位置の上書き、クリップボードの読み取り/置換）、アプリ管理（一覧、フォアグラウンドアプリ、起動、終了、インストール、アンインストール）、画面操作（スクリーンショット、スクリーンショットの保存、座標付きUI要素の一覧、タップ、ダブルタップ、長押し、スワイプ、画面録画）、入力とナビゲーション（テキスト入力、ハードウェアボタン、URLを開く）、ログとクラッシュレポート（デバイスログ、クラッシュの一覧と取得）をカバーします。バッチコマンドツールは、1回の呼び出しで複数のツールを順番に実行します。リモートデバイスツールでは、クラウドプロバイダーへのログイン、クラウドデバイスの一覧、割り当て、解放が可能です。 このプロジェクトはアクセシビリティファーストのアプローチを重視しています。ビジョンモデルではなくネイティブのアクセシビリティツリーからアプリを操作し、必要に応じてスクリーンショットと座標にフォールバックします。READMEでは、これをスクリーンショットのみのアプローチよりも高速で安価であると説明しています。出力は構造化され決定論的であると記述されています。 前提条件には、Xcodeコマンドラインツール、Androidプラットフォームツール、Node.js v20以降、MCP対応のエージェントまたはモデルが含まれます。Amp、Antigravity、Cline、Claude Code、Claude Desktop、Codex、Copilot、Cursor、Gemini CLI、Goose、Kiro、opencode、Windsurfなど、多くのクライアント向けの設定例が提供されています。環境変数は、認証、テレメトリのオプトアウト、安全でないURLスキーム、レガシーロボットモードを制御します。匿名テレメトリはデフォルトで収集され、無効化できます。 リポジトリは関連プロジェクトも示しています。反復可能で決定論的なモバイルテストのためのmobilewright、基盤となるデバイスCLIとしてのmobilecli、オンデマンドの実機向けクラウドサービスです。ドキュメント、ロードマップ、コントリビューションガイドライン、行動規範がリンクされています。READMEには、このサーバーはローカルで実行され、接続されたデバイスとのみ通信し、データ収集の詳細については別途プライバシーポリシーがあると記載されています。