Mobile Development MCP

モバイル開発 MCP

Model Context Protocol を通じて、AI でモバイルデバイスを操作できます！

これは、モバイルデバイスやシミュレーターの管理と操作を目的とした MCP です。iOS および Android の開発環境向けに、アプリのインストール、デバイスの管理、ログの取得などのタスクを実行するユーティリティを提供します。

機能

• デバイス管理：接続されているデバイスやシミュレーターの起動、シャットダウン、一覧表示を行います。
• アプリケーション管理：対象デバイスへのアプリケーションのインストール、起動、管理を行います。
• ビジュアル診断：デバイスやシミュレーターの画面のスクリーンショットを撮影します。
• ファイル管理：接続されているデバイスへのファイルの送信や、デバイスからのファイルの取得を簡単に行えます。
• UI 自動化：タップ、スワイプ、テキスト入力によってデバイスを操作します。
• ログ管理：接続されているデバイスからログファイルやシステム情報を取得します。
• クロスプラットフォーム対応：Android と iOS の両方の環境に対応しています。

前提条件

このサーバーを使用するには、開発マシンに以下のツールがインストールされていることを確認してください。

• Android デバイス管理用の ADB（Android Debug Bridge）。
• iOS シミュレーター管理用の Xcode Command Line Tools（xcrun simctl）。
• Facebook の IDB ツール（インストールガイドを参照）（iOS での UI 自動化にのみ必要）。
• .NET SDK（例：.NET 9）

セットアップ

1. このリポジトリをクローンします
2. プロジェクトディレクトリに移動します
3. プロジェクトをビルドします：dotnet build
4. VS Code またはその他のクライアントで設定します：

"mcp-server-mobiledev": {
    "type": "stdio",
    "command": "dotnet",
    "args": [
        "run",
        "--project",
        "/Users/jsuarezruiz/GitHub/mobile-dev-mcp-server/src/MobileDevMcpServer.csproj"
    ]
}

テスト

MCP Inspector は、MCP サーバーのテストとデバッグを目的とした対話型の開発者ツールです。以下のコマンドを使用して、アプリケーションフォルダーから nodejs コマンドの npx で Inspector を起動できます。

npx @modelcontextprotocol/inspector dotnet run

ツール

• android_list_devices：接続されているすべての Android デバイスの詳細を取得します。
• android_list_packages：特定の Android デバイスにインストールされているすべてのアプリケーションを一覧表示します。
• android_install_app：Android デバイスにアプリケーション（APK）をインストールします。
• android_launch_app：Android デバイスで特定のアプリケーションを起動します。
• android_diagnostics_bug_report：Android デバイスから包括的なバグレポートを取得します。
• android_logs_logcat：logcat を使用して Android デバイスからシステムログを取得します。
• android_logs_logcat_log_level：ログレベルを指定して、logcat を使用し Android デバイスからシステムログを取得します。
• android_files_push：ローカルファイルを Android デバイスに送信します。
• android_files_pull：Android デバイスからローカルマシンにファイルを取得します。
• android_files_delete_file：接続されている Android デバイスから指定したファイルを削除します。
• android_ui_tap：Android デバイスの指定した画面座標でタップ操作をシミュレートします。
• android_ui_swipe：Android デバイスの画面上で、2 点間のスワイプ操作をシミュレートします。
• android_ui_input_text：Android デバイスのフィールドへのテキスト入力をシミュレートします。
• android_ui_press_key：シリアル番号とキーコードを使用して、Android デバイスでのキー押下をシミュレートします。
• android_screenshot：指定した Android デバイスのスクリーンショットを取得します。
• android_compare_screenshot_llm：指定したプロンプトと LLM（大規模言語モデル）との対話を使用して、2 つのスクリーンショットを比較します。
• android_shell_command：Android デバイスでシェルコマンドを実行します。
• ios_list_devices：接続されているすべての iOS シミュレータデバイスの詳細を取得します。
• ios_booted_device：最初に起動したシミュレータデバイスの名前と ID を取得します。
• ios_boot_device：指定した iOS シミュレータデバイスを起動します。
• ios_launch_app：指定した iOS シミュレータデバイスでアプリケーションを起動します。
• ios_shutdown_device：指定した iOS シミュレータデバイスをシャットダウンします。
• ios_ui_tap：iOS デバイスの指定した画面座標でタップ操作をシミュレートします。
• ios_ui_swipe：iOS デバイスの画面上で、2 点間のスワイプ操作をシミュレートします。
• ios_ui_input_text：iOS デバイスのフィールドへのテキスト入力をシミュレートします。
• ios_ui_press_key：iOS デバイスで特定のキーを押す操作をシミュレートします。
• ios_screenshot：指定した iOS デバイスのスクリーンショットを取得します。
• ios_video_start：iOS シミュレータの動画を録画します。
• ios_video_stop：シミュレータの動画録画を停止します。

AI アシスタントへのクエリ例

次のクエリをお試しください。

• 「現在接続されているすべての Android デバイスを表示し、詳細を教えてください。」
• 「接続されているすべての iOS デバイスと、その仕様を表示してください。」
• 「最近のログを分析し、エラーメッセージがないか確認してください。」
• 「この APK をデバイスにインストールして、正しくインストールされたか確認してください。」
• 「スマートフォンにインストールされているすべてのアプリケーションの一覧を表示してください。」
• 「座標 (100, 1000) にあるホームボタンを押してください。」

ギャラリー

コントリビューション

このプロジェクトの改善に向けたコントリビューションを歓迎します。バグの修正、新機能の追加、ドキュメントの改善など、皆さまのご協力に心より感謝します。

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/my-feature）
3. 変更を加えます
4. 変更をコミットします（git commit -m 'Add a new feature'）
5. ブランチにプッシュします（git push origin feature/my-feature）
6. プルリクエストを作成します

ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。