mcp-server-adb

mcp-server-adb

Android Debug Bridge（ADB）を制御するための Model Context Protocol サーバー

これは、ADB 制御システムを実装した TypeScript ベースの MCP サーバーです。AI アシスタントが ADB コマンドを通じて Android デバイスを操作できるようにし、以下を提供します。

• デバイスの検出と情報取得のためのリソース
• デバイス制御とアプリ管理のためのツール
• デバイスの分析と診断のためのプロンプト

機能

リソース

• device://list で接続済みデバイスを一覧表示
• device://{serial}/info でデバイス情報にアクセス
• device://{serial}/packages でインストール済みパッケージを表示
• device://{serial}/screenshot でスクリーンショットを撮影

ツール

デバイス制御

• connect_device - 指定したデバイスに接続
• disconnect_device - デバイスから切断

デバイス操作

• tap - 画面をタップ
• swipe - 画面をスワイプ
• input_text - テキストを入力
• press_key - キーを押す
• take_screenshot - スクリーンショットを撮影

アプリケーション管理（近日公開）

• install_app - APK をインストール
• uninstall_app - アプリケーションをアンインストール
• start_app - アプリケーションを起動
• stop_app - アプリケーションを停止

プロンプト

• analyze_device - デバイスの状態と仕様を分析
• analyze_app_list - インストール済みアプリケーションを分析
• analyze_screen - 現在の画面の内容を分析

前提条件

• Node.js 16 以降
• Android Debug Bridge（ADB）がインストールされ、PATH から利用できること
• USB デバッグまたはネットワーク ADB が有効になっている Android デバイス

開発

依存関係をインストールします。

npm install

サーバーをビルドします。

npm run build

自動再ビルドを有効にして開発する場合：

npm run watch

インストール

Claude Desktop で使用するには、サーバー設定を追加します。

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-adb": {
      "command": "/path/to/mcp-server-adb/build/index.js"
    }
  }
}

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします。

npm run inspector

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。

デバイスのセットアップ

1. Android デバイスで USB デバッグを有効にします。

   • 設定 > デバイス情報に移動します
   • 「ビルド番号」を 7 回タップして、開発者向けオプションを有効にします
   • 設定 > 開発者向けオプションに移動します
   • 「USB デバッグ」を有効にします

2. ネットワーク経由でデバッグする場合：

   • まずデバイスを USB で接続します
   • 開発者向けオプションで「ワイヤレスデバッグ」を有効にします
   • デバイスの IP アドレスを指定して connect_device ツールを使用します

ライセンス

MIT