Adb MCP

🚀 ADB MCP

Androidデバイスの自動化のためにAndroid Debug Bridge (ADB) 機能を提供するモデルコンテキストプロトコル (MCP) サーバーです。

✨ 主な機能

デバイス管理

• 接続されているデバイスを一覧表示する
• デバイス情報を取得する
• 操作のデフォルトデバイスを設定する
• デバイスの接続状態を確認する

画面操作

• スクリーンショットを撮る
• 指定座標をクリックする
• スワイプジェスチャーを実行する
• テキストを入力する
• キーを押す

アプリ管理

• アプリをインストール/アンインストールする
• アプリを起動/停止する
• インストールされているアプリを一覧表示する
• アプリ情報を取得する

ファイル操作

• ファイルをデバイスに転送する
• ファイルをデバイスから取得する
• ファイルとディレクトリを一覧表示する
• ディレクトリを作成する
• ファイルを削除する

シェルコマンド

• シェルコマンドを実行する
• システム情報を取得する
• バッテリー情報を取得する
• ログ出力を取得する

📦 インストール

1. リポジトリをクローンする

2. 依存関係をインストールする:

   npm install
   

3. プロジェクトをビルドする:

   npm run build
   

💻 使用例

前提条件

• Android Debug Bridge (adb) がインストールされ、PATHに含まれている必要があります。
• USBデバッグが有効になっているAndroidデバイスをUSBで接続する必要があります。
• デバイスはデバッグ用に承認されている必要があります。

サーバーの起動

npm start

利用可能なツール

デバイス管理

• adb_list_devices - 接続されているすべてのデバイスを一覧表示する
• adb_get_device_info - デバイス情報を取得する
• adb_set_default_device - デフォルトデバイスを設定する

画面操作

• adb_screenshot - スクリーンショットを撮る
• adb_click - 指定座標をクリックする
• adb_swipe - スワイプジェスチャーを実行する
• adb_input_text - テキストを入力する
• adb_press_key - キーを押す

アプリ管理

• adb_install_app - APKをインストールする
• adb_uninstall_app - アプリをアンインストールする
• adb_start_app - アプリを起動する
• adb_stop_app - アプリを停止する
• adb_list_apps - インストールされているアプリを一覧表示する

ファイル操作

• adb_push_file - ファイルをデバイスに転送する
• adb_pull_file - ファイルをデバイスから取得する
• adb_list_files - ディレクトリ内のファイルを一覧表示する

シェルコマンド

• adb_shell - シェルコマンドを実行する
• adb_get_system_info - システム情報を取得する
• adb_get_battery_info - バッテリー情報を取得する
• adb_get_logcat - ログ出力を取得する

🔧 技術詳細

サーバーには基本的なセキュリティ対策が含まれています。

• 危険なシェルコマンドはブロックされます。
• ファイルパスの検証が行われます。
• デバイスの接続検証が行われます。
• 入力のサニタイズが行われます。

開発

ビルド

npm run build

開発モード

npm run dev

リント

npm run lint

MCP

      "mcpServers": {
        "adb-mcp": {
          "type": "stdio",
          "command": "node",
          "args": [
            "/adb-mcp/dist/index.js"
          ],
          "env": {
            "ADB_DOWNLOAD_PATH": "/adb-mcp",
            "MCP_READ_PATH": "/adb-mcp"
          }
        }
      }

📄 ライセンス

MIT