ADB MCP 服务器

ADB MCP サーバー

これは Android Debug Bridge（ADB）用の MCP サーバーで、Claude が Android デバイスとやり取りできるようにします。

技術記事

• 0 から 1 へ：Android MCP サービスの開発 — MCP プロトコルと ADB の統合を理解する

ツール一覧

1. get-devices

   • 接続済みの Android デバイスを一覧表示します
   • オプションのパラメーター：
     • showDetails（ブール値、デフォルト：true）：デバイスの詳細情報を表示します（-l）

2. list-packages

   • デバイスにインストールされているパッケージを一覧表示します
   • オプションのパラメーター：
     • showPath（ブール値、デフォルト：false）：APK ファイルのパスを表示します（-f）
     • showDisabled（ブール値、デフォルト：false）：無効化されたパッケージのみを表示します（-d）
     • showEnabled（ブール値、デフォルト：false）：有効化されたパッケージのみを表示します（-e）
     • showSystem（ブール値、デフォルト：false）：システムパッケージのみを表示します（-s）
     • showThirdParty（ブール値、デフォルト：false）：サードパーティ製パッケージのみを表示します（-3）
     • showInstaller（ブール値、デフォルト：false）：パッケージインストーラーを表示します（-i）
     • includeUninstalled（ブール値、デフォルト：false）：アンインストール済みのパッケージを含めます（-u）

3. input-text

   • デバイスにテキストを入力します
   • 必須パラメーター：
     • text（文字列）：入力するテキスト

4. install-apk

   • APK ファイルをデバイスにインストールします
   • 必須パラメーター：
     • apkPath（文字列）：APK ファイルのパス
   • オプションのパラメーター：
     • allowReinstall（ブール値、デフォルト：true）：再インストールを許可します（-r）
     • allowTestPackages（ブール値、デフォルト：true）：テストパッケージを許可します（-t）
     • allowDowngrade（ブール値、デフォルト：true）：ダウングレードを許可します（-d）
     • grantPermissions（ブール値、デフォルト：false）：すべての権限を付与します（-g）

5. uninstall-apk

   • アプリケーションをアンインストールします
   • 必須パラメーター：
     • packageName（文字列）：アンインストールするパッケージ名
   • オプションのパラメーター：
     • keepData（ブール値、デフォルト：false）：アプリのデータとキャッシュを保持します（-k）

6. clear-app-data

   • アプリケーションのデータを消去します
   • 必須パラメーター：
     • packageName（文字列）：データを消去するパッケージ名

7. pull

   • デバイスからファイルを取得します
   • 必須パラメーター：
     • remotePath（文字列）：デバイス上のファイルパス
   • オプションのパラメーター：
     • localPath（文字列）：ローカルの保存先パス

8. push

   • デバイスにファイルを転送します
   • 必須パラメーター：
     • localPath（文字列）：ローカルファイルのパス
     • remotePath（文字列）：デバイス上の保存先パス

9. screencap

   • スクリーンショットを撮影します
   • 必須パラメーター：
     • remotePath（文字列）：デバイス上でスクリーンショットを保存するパス（例：/sdcard/screenshot.png）
   • オプションのパラメーター：
     • usePng（ブール値、デフォルト：true）：PNG 形式で保存します（-p）

10. rm

    • Android デバイスからファイルを削除します
    • 必須パラメーター：
      • path（文字列）：削除するデバイス上のファイルパス
    • オプションのパラメーター：
      • force（ブール値、デフォルト：false）：強制的に削除します（-f）
      • recursive（ブール値、デフォルト：false）：再帰的に削除します（-r）

11. reset-permissions

    • アプリのすべての権限をリセットします
    • 必須パラメーター：
      • packageName（文字列）：対象のパッケージ名

12. grant-permission

    • 特定の権限を付与します
    • 必須パラメーター：
      • packageName（文字列）：対象のパッケージ名
      • permission（文字列）：付与する権限

セットアップ手順

1. ADB をインストールします：

   • Android SDK Platform Tools をダウンロードします
   • ADB をシステム環境変数に追加します
   • adb version を実行してインストールを確認します

2. USB デバッグを有効にします：

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

サーバーのインストール

# 克隆仓库
git clone [repository-url]
cd mcp-server-adb

# 安装依赖
npm install

# 构建项目
npm run build

Claude Desktop での使用

claude_desktop_config.json に以下の内容を追加します：

{
  "mcpServers": {
    "adb": {
      "command": "node",
      "args": ["-y", "/path/to/mcp-server-adb/build/index.js", "/path/to/adb"]
    }
  }
}

/path/to/adb を実際の ADB 実行可能ファイルのパスに置き換えてください。

Windsurf での使用

1. まず、Node.js と ADB がインストールされていることを確認します

2. プロジェクトをクローンしてビルドします：

   git clone https://github.com/jiantao88/android-mcp-server.git
   cd android-mcp-server
   npm install
   npm run build
   

   または、クローン済みのプロジェクトを直接使用します：

   cd /path/to/android-mcp-server
   npm install
   npm run build
   

3. Windsurf の設定に MCP 設定を追加します：

   {
     "mcpServers": {
       "adb": {
         "command": "node",
         "args": [
           "/path/to/android-mcp-server/build/index.js",
           "/usr/local/bin/adb"
         ]
       }
     }
   }
   

   注意：

   • パス内のパスを実際のパスに置き換えてください
   • /usr/local/bin/adb は ADB のデフォルトのインストールパスです。ADB が別の場所にインストールされている場合は、適宜変更してください
   • すべてのパスが絶対パスであることを確認してください

4. 設定を反映するため、Windsurf を再起動します

ライセンス

本プロジェクトは MIT ライセンスを採用しています。詳しくは LICENSE ファイルをご覧ください。