MCP Server Adb

🚀 mcp-server-adb サーバー

TypeScript ベースの MCP サーバーで、Android デバッグブリッジ（ADB）を通じた制御を可能にします。このサーバーは、AI アシスタントが ADB コマンドを使用して Android デバイスとやり取りできるようにし、以下の機能を提供します。

• デバイスの検出と情報取得
• デバイスの制御とアプリケーション管理ツール
• デバイスの分析と診断情報

✨ 主な機能

リソース

• 接続されたデバイスの一覧を表示：device://list
• デバイス情報を取得：device://{serial}/info
• インストールされたパッケージを表示：device://{serial}/packages
• スクリーンショットを取得：device://{serial}/screenshot

ツール

1. デバイス制御ツール

   • connect_device：ネットワーク経由でデバイスに接続
   • disconnect_device：ネットワーク接続されたデバイスを切断

2. アプリケーション管理ツール

   • install_app：APK ファイルをインストール
   • uninstall_app：インストールされたアプリケーションをアンインストール
   • start_app：アプリケーションを起動
   • stop_app：アプリケーションを強制終了

3. デバイス入力ツール

   • tap：画面タップをシミュレート
   • swipe：画面スワイプをシミュレート
   • input_text：テキストを入力
   • press_key：キーの押下をシミュレート
   • take_screenshot：スクリーンショットを取得

診断

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

📦 インストール

前提条件

• Node.js 16 以上
• Android デバッグブリッジ（ADB）がインストールされ、PATH 環境変数に設定されていること
• USB デバッグが有効になっている Android デバイス、またはネットワーク ADB をサポートするデバイス

開発環境のセットアップ

依存関係をインストール：

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 サーバーは標準入出力を通じて通信するため、デバッグは難しい場合があります。MCP インスペクターを使用することをおすすめします。これはパッケージスクリプトとして提供されています。

npm run inspector

インスペクターは、ブラウザでデバッグツールにアクセスするための URL を提供します。

デバイスの設定

1. Android デバイスで USB デバッグを有効にする：

   • 設定 > 端末情報 を開く
   • 「ビルド番号」を 7 回タップして開発者向けオプションを有効にする
   • 設定 > 開発者向けオプション を開く
   • 「USB デバッグ」を有効にする

2. ネットワークデバッグの場合：

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