MCP Adb

🚀 MCP-ADB

このプロジェクトは、Androidデバッグブリッジ（ADB）との統合を提供するモデルコンテキストプロトコル（MCP）サーバーです。AIアシスタントがAndroidデバイスと相互作用できるようにします。

✨ 主な機能

• スクリーンショットの取得：接続されたAndroidデバイスのスクリーンショットを取得し、自動的にサイズを調整します。
• Base64画像データ：スクリーンショットデータをBase64エンコードされた文字列として直接受け取ります。
• キーイベント制御：Androidデバイスにキーイベント（ナビゲーション、戻る、ホーム）を送信します。
• 複数デバイス対応：複数のデバイスが接続されている場合、ターゲットデバイスを指定できます。
• デバイスリスト：接続されたすべてのAndroidデバイスをリソースとしてリストします。
• リソースアクセス：リソースURIを介してスクリーンショットやデバイス情報にアクセスできます。

📦 インストール

前提条件

• Node.js（推奨v16以上）
• Androidデバッグブリッジ（ADB）がインストールされ、PATH環境変数に追加されているか、ADB_PATH環境変数で設定されている必要があります。
• USBデバッグが有効になっている接続済みのAndroidデバイス。

インストール手順

# リポジトリをクローン
git clone https://github.com/isseikz/mcp-adb.git
cd mcp-adb

# 依存関係をインストール
npm install

# プロジェクトをビルド
npm run build

💻 使用例

Claude Desktopとの連携

このMCPサーバーをClaude Desktopと一緒に使用するには、Claude Desktopのインストールディレクトリにあるclaude_desktop_config.jsonファイル、またはClaude - 設定 - 開発者 - 設定の編集から見つけられる該当ファイルにmcp - adbの設定を追加してください。

以下は設定例です。

{
  "mcpServers": {
    "mcp-adb": {
      "command": "node",
      "args": ["/path/to/mcp-adb/build/index.js"],
      "env": {
        "ADB_PATH": "/path/to/adb"
      }
    }
  }
}

利用可能なツール

スクリーンショットツール

接続されたAndroidデバイスのスクリーンショットを取得し、自動的に幅を640pxに調整します。

パラメータ：

• deviceId（オプション）：複数のデバイスが接続されている場合、ターゲットデバイスを指定します。

応答：

• 応答に直接Base64エンコードされた画像データ（PNG形式）を返します。

例：

{
  "name": "screenshot",
  "arguments": {
    "deviceId": "emulator-5554"
  }
}

キー押下ツール

接続されたAndroidデバイスにキーイベントを送信します。

パラメータ：

• keycode：送信するAndroidキーコード（以下のリストを参照）
• deviceId（オプション）：複数のデバイスが接続されている場合、ターゲットデバイスを指定します。

利用可能なキーコード：

• KEYCODE_DPAD_CENTER - センター/決定ボタン
• KEYCODE_DPAD_DOWN - 下ナビゲーションキー
• KEYCODE_DPAD_UP - 上ナビゲーションキー
• KEYCODE_DPAD_LEFT - 左ナビゲーションキー
• KEYCODE_DPAD_RIGHT - 右ナビゲーションキー
• KEYCODE_DPAD_UP_LEFT - 左上斜めナビゲーションキー
• KEYCODE_DPAD_UP_RIGHT - 右上斜めナビゲーションキー
• KEYCODE_DPAD_DOWN_LEFT - 左下斜めナビゲーションキー
• KEYCODE_DPAD_DOWN_RIGHT - 右下斜めナビゲーションキー
• KEYCODE_HOME - ホームキー
• KEYCODE_BACK - 戻るキー

例：

{
  "name": "keyDown",
  "arguments": {
    "deviceId": "emulator-5554",
    "keyCode": "KEYCODE_HOME"
  }
}

📚 ドキュメント

リソースURIアクセス

以下のURI形式でリソースにアクセスできます。

• mctp://<host>:<port>/screenshot - スクリーンショットを取得します。
• mctp://<host>:<port>/devices - 接続されたすべてのデバイスのリストを取得します。

プロジェクト構造

.
├── package.json          # プロジェクトの依存関係とスクリプトの設定
├── src                  # ソースコードディレクトリ
│   ├── index.js         # メインプログラムのエントリーファイル
│   └── screenshot.js    # スクリーンショット処理ロジック
└── README.md            # プロジェクトドキュメント

📄 ライセンス

MIT

貢献

貢献を歓迎します！Pull Requestを随時送信してください。