ADB MCP Server

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）で構築