ADB MCP サーバー
ADBを介してAndroidデバイスとやり取りするためのMCP（Model Context Protocol）サーバー。このTypeScriptベースのツールは、AIモデルとAndroidデバイスの機能をつなぐ橋渡しとなります。
特徴
📱 デバイス管理 - 接続されている Android デバイスの一覧表示と操作
📦 アプリのインストール - 接続されたデバイスに APK ファイルを展開する
📋 ログ記録 - logcat を通じてデバイスのログにアクセスする
🔄 ファイル転送 - デバイスとホスト間でファイルをプッシュおよびプルします
📸 UIインタラクション - スクリーンショットをキャプチャし、UI階層を分析する
🔧 シェルコマンド実行 - デバイス上でカスタムコマンドを実行する
Related MCP server: Android ADB MCP Server
前提条件
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ファイルを参照してください。