ADB MCP サーバー

ADBを介してAndroidデバイスとやり取りするためのMCP（Model Context Protocol）サーバー。このTypeScriptベースのツールは、AIモデルとAndroidデバイスの機能をつなぐ橋渡しとなります。

特徴

• 📱 デバイス管理 - 接続されている Android デバイスの一覧表示と操作

• 📦 アプリのインストール - 接続されたデバイスに APK ファイルを展開する

• 📋 ログ記録 - logcat を通じてデバイスのログにアクセスする

• 🔄 ファイル転送 - デバイスとホスト間でファイルをプッシュおよびプルします

• 📸 UIインタラクション - スクリーンショットをキャプチャし、UI階層を分析する

• 🔧 シェルコマンド実行 - デバイス上でカスタムコマンドを実行する

前提条件

• Node.js (v16 以上を推奨、Node.js v16、v18、v20 でテスト済み)

• ADB (Android Debug Bridge) がインストールされ、PATH に含まれている

• USBデバッグが有効になっているUSBまたはネットワーク経由で接続されたAndroidデバイスまたはエミュレータ

• デバイスへのアクセス許可（デバイス上でデバッグ承認を承認）

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の ADB Android Device Server を自動的にインストールするには:

手動インストール

構成

ADBパス構成

サーバーはデフォルトのADBパスを使用します。カスタムADBの場所を指定する場合は、以下の手順に従ってください。

MCP構成

ADB MCP サーバー構成を追加します。

使用法

サーバーの起動

重要: ADB ツールを使用する前に、サーバーが実行されている必要があります。

次を使用してサーバーを起動します。

次のように表示されます。

ADB ツールを使用する間は、このターミナル ウィンドウを開いたままにしておきます。

利用可能なツール

すべてのツールは、次の命名規則に従って使用できます。

📱 デバイス管理

• adb_devices - 接続されているデバイスを一覧表示する

• adb_shell - デバイス上でシェルコマンドを実行する

📦 アプリ管理

• adb_install - ローカルファイルパスを使用して APK ファイルをインストールする

📋 ログ記録

• adb_logcat - オプションのフィルタリングを使用してデバイスログを表示する

🔄 ファイル転送

• adb_pull - デバイスからファイルを取得する

• adb_push - デバイスにファイルをプッシュする

🔍 UIインタラクション

• dump_image - 現在の画面のスクリーンショットを撮る

• inspect_ui - XML 形式で UI 階層を取得します (AI とのやり取りに最も役立ちます)

トラブルシューティング

ツールが動作しない場合は:

• サーバーの問題:

  • サーバーが実行中であることを確認する ( npx adb-mcp )

  • サーバー出力のエラーメッセージを確認する

  • 詳細ログを試してください: LOG_LEVEL=3 npx adb-mcp

  • ハングしているプロセスを強制終了する:

    • ps aux | grep "adb-mcp" | grep -v grep

    • それからkill -9 [PID]

• デバイス接続:

  • adb_devicesで接続を確認する

  • 「許可されていない」場合は、デバイスでデバッグ許可を受け入れます

  • USB/ネットワーク接続を確認する

  • ADBを再起動してみてください: adb kill-server && adb start-server

• ADBの問題:

  • ADBのインストールを確認する: adb version

• デバイスのセットアップ:

  • エミュレータを使用します (エミュレータを使用して構築されています)。実際のデバイスの場合は、これを試してください。

    • USBデバッグが有効になっていることを確認する

    • 新しいAndroidバージョンでは、「USBデバッグ（セキュリティ設定）」を有効にしてください

    • 別のUSBポートまたはケーブルを試してください

    • または問題で私に知らせてください

互換性

• Android 8.0以降

• カーソル IDE の Claude を含む MCP クライアント

• macOS 上で構築されていますが、POSIX 互換のもの (Linux など) でも実行できるはずです。

• Windows では試していませんが、おそらく動作するでしょう。

貢献

• 貢献を歓迎します! プルリクエストを送信してください。

• 大きな変更については、まず議論するために問題を開いてください。

• もちろんフォークすることもできます

• **注:**このプロジェクトはvibe-codedているので、何か変なものを見つけたら...もうお分かりですね 🙂

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

謝辞

• モデルコンテキストプロトコル（MCP）で構築