Adb MCP Server

🚀 ADB MCP サーバー

このサーバーは、Android デバッグブリッジ (ADB) 接続を管理し、Android デバイスとのやり取りを行うための Model Context Protocol (MCP) サーバーです。

✨ 主な機能

• デバイス管理：接続されているすべての Android デバイスを一覧表示します。
• スクリーンショット取得：接続されたデバイスからスクリーンショットを取得します。
• UI 要素検査：デバイス画面の UI 階層構造を抽出します。
• ADB コマンド実行：接続されたデバイス上で任意の ADB コマンドを実行します。

📦 インストール

前提条件

• Android デバッグブリッジ (ADB) がシステムにインストールされ、PATH 環境変数に追加されている必要があります。
• Node.js (バージョン 14 以上)
• TypeScript

インストール手順

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/adb-mcp-server.git
   cd adb-mcp-server
   

2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

💻 使用例

サーバーの起動

ADB MCP サーバーは、Model Context Protocol サーバーとして stdio を介して実行されます：

npm start

開発時には、ファイルの変更を検知して自動的に再起動する機能付きで実行できます：

npm run dev

利用可能なツール

サーバーは以下の MCP ツールを公開しています：

1. 接続デバイスの一覧取得

get_devices

接続されているすべての Android デバイスとその ID および接続状態の一覧を返します。

2. スクリーンショットの取得

capture_screenshot

パラメータ：

• deviceId：スクリーンショットを取得するデバイスの ID
• path：スクリーンショットを保存するパス

スクリーンショットは YYYYMMDD_HH_MM_SS.png の形式で命名されます。

3. UI 要素の取得

get_ui_elements

パラメータ：

• deviceId：UI 階層構造を抽出するデバイスの ID

UI 自動化やテストに適した XML 形式で、完全な UI 階層構造を返します。

4. ADB コマンドの実行

execute_adb_command

パラメータ：

• deviceId：コマンドを実行するデバイスの ID
• command：実行する ADB コマンド

指定されたデバイス上で任意の ADB コマンドを実行できます。

📚 ドキュメント

プロジェクト構造

adb-mcp-server
├── src
│   ├── index.ts               # 主な MCP サーバーのエントリポイント
│   ├── handlers/              # 各機能のリクエストハンドラー
│   │   ├── deviceList.ts      # デバイスリスト機能
│   │   ├── screenshot.ts      # スクリーンショット取得機能
│   │   └── uiElements.ts      # UI 階層構造抽出機能
│   ├── utils/                 # ユーティリティ関数
│   │   ├── adb.ts             # ADB コマンド実行ユーティリティ
│   │   └── screenshot.ts      # スクリーンショット処理ユーティリティ
│   └── types/                 # TypeScript の型定義
├── package.json               # プロジェクトの依存関係とスクリプト
└── tsconfig.json              # TypeScript の設定

🤝 貢献

貢献を歓迎します！自由に Pull Request を送信してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。