Adb MCP

🚀 ADB MCP サーバー

このツールは TypeScript で開発され、Android Debug Bridge (ADB) を通じて Android デバイスとやり取りするためのものです。AI モデルと Android デバイスの機能の間に橋渡しをします。

✨ 主な機能

• 📱 デバイス管理 - 接続された Android デバイスを一覧表示し、操作します。
• 📦 アプリケーションのインストール - 接続されたデバイスに APK ファイルをデプロイします。
• 📋 ログ記録 - デバイスのログ情報にアクセスします（logcat を通じて）。
• 🔄 ファイル転送 - デバイスとホスト間でファイルをプッシュおよびプルします。
• 📸 UI インタラクション - スクリーンショットをキャプチャし、UI 階層構造を分析します。
• 🔧 Shell コマンドの実行 - デバイス上でカスタムコマンドを実行します。

📦 インストール

前提条件

• Node.js (バージョン v16 以上を推奨。Node.js v16、v18、v20 でテスト済み)
• ADB (Android Debug Bridge) がインストールされ、PATH 環境変数に設定されていること
• USB またはネットワークを介してコンピューターに接続され、USB デバッグモードが有効になっている Android デバイスまたはエミュレーター
• デバイスへのアクセス権限（デバッグ承認を受けていること）

インストール手順

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

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

# TypeScript コードをビルドする
npm run build

# サーバーを起動する
npx adb-mcp

📚 ドキュメント

ADB パスの設定

サーバーはデフォルトの ADB パスを使用します。カスタムパスを指定する場合は、以下のようにします。

export ADB_PATH=/path/to/adb
npx adb-mcp

MCP 設定

ADB MCP サーバーの設定を追加します。

{
  "mcpServers": {
    "adb": {
      "command": "npx",
      "args": [
        "adb-mcp"
      ]
    }
  }
}

💻 使用例

サーバーの起動

注意：ADB ツールを使用する前に、必ずサーバーが起動していることを確認してください。 以下のコマンドでサーバーを起動します。

npx adb-mcp

次のようなメッセージが表示されるはずです。

[INFO] ADB MCP サーバーが接続され、準備が整いました

ADB ツールを実行している間は、このターミナルウィンドウを開いたままにしてください。

利用可能なツール

• デバイス管理：接続された Android デバイスを一覧表示し、操作するためのものです。
• アプリケーションのインストール：接続されたデバイスに APK ファイルをデプロイします。
• ログ記録：logcat を通じてデバイスのログ情報にアクセスします。
• ファイル転送：デバイスとホスト間でファイルをプッシュおよびプルします。
• UI インタラクション：スクリーンショットをキャプチャし、UI 階層構造を分析します。
• Shell コマンドの実行：デバイス上でカスタムコマンドを実行します。

🔧 トラブルシューティング

サーバーの問題

サーバーが起動しない場合は、Node.js と npm が正しくインストールされていること、およびすべての依存関係がインストールされていることを確認してください。

デバイス接続の問題

• デバイスが USB またはネットワークを介してコンピューターに正しく接続されていることを確認してください。
• デバイスで USB デバッグモードが有効になっていることを確認してください。

ログ記録の問題

ログを表示できない場合は、logcat が正しく設定されていること、およびデバイスが接続されていることを確認してください。

互換性

• サポートされる Android バージョン：ADB をサポートするすべての Android システム
• サポートされるオペレーティングシステム：Windows、Linux、macOS

貢献ガイド

貢献の方法

• GitHub リポジトリに問題や提案を投稿してください。
• 問題を修正するか、機能を追加するためのプルリクエストを作成してください。

📄 ライセンス

このプロジェクトは [LICENSE] ライセンスに従います。