Android ADB MCP サーバー

AIアシスタントがAndroid Debug Bridge（ADB）を介してAndroidデバイスと対話できるようにするModel Context Protocol（MCP）サーバー。このサーバーはAI機能とAndroidデバイス管理のギャップを埋め、Android開発とテスト運用のシームレスな自動化を実現します。

⚙️ クイックセットアップ

サーバーを MCP 構成ファイルに追加します。

{
  "mcpServers": {
    "android-adb": {
      "command": "npx",
      "args": ["-y", "@landicefu/android-adb-mcp-server"],
      "env": {},
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

構成場所

• Claude デスクトップ: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

• Cline/Roo コード: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json (macOS)

• Windows/Linuxの場合は、同等のアプリケーションサポートディレクトリを確認してください。

設定後、AI アシスタントを再起動して新しいサーバー設定を読み込みます。

Related MCP server: MCP Android Agent

📋 前提条件

• **ADB (Android Debug Bridge)**がインストールされ、システム PATH で利用可能になっている必要があります。

  • Windows、macOS、LinuxにADBをインストールする

  • ターミナルでadb versionを実行してインストールを確認します。

• クリップボード機能の場合:

  • macOS : osascript （組み込み）

  • Windows : PowerShell (組み込み)

  • Linux : xclip ( apt-get install xclipまたは同等のコマンドでインストール)

• Node.js 16.x 以上

🚀 機能

• 複数の Android デバイスに接続して管理する

• Androidデバイスでシェルコマンドを実行する

• アプリケーションのインストールとアンインストール

• ローカルシステムと Android デバイス間でファイルをプッシュおよびプルする

• Androidデバイスでアプリケーションを起動する

• スクリーンショットを撮ってローカルに保存するか、クリップボードにコピーします

• 複数のデバイスが接続されている場合のスマートデバイスの選択

🛠️ 利用可能なツール

デバイス管理

サーバーはデバイスの選択をインテリジェントに処理します。

• 接続されているデバイスが1つだけの場合は、自動的に使用されます

• 複数のデバイスが接続されている場合は、 device_idパラメータを指定する必要があります。

• デバイスが接続されていない場合はエラーが返されます

スクリーンショットのパス解像度

スクリーンショットを保存するためのoutput_path指定すると、パスは次のように解決されます。

• 絶対パスはそのまま使用されます

• ~で始まるパスはユーザーのホームディレクトリに展開されます

• 相対パスはユーザーのホームディレクトリを基準に解決されます

これにより、スクリーンショットは MCP サーバーが書き込み権限を持つ場所に保存されるようになります。

🔍 トラブルシューティング

よくある問題

1. 「ADBは利用できません」というエラー

   • ADBがインストールされ、システムPATHに含まれていることを確認してください

   • ターミナルでadb versionを実行して確認します

2. 「Androidデバイスが接続されていません」というエラー

   • デバイスがadb devicesに正しく接続されているか確認してください

   • デバイスでUSBデバッグが有効になっていることを確認してください

   • adb kill-serverとadb start-serverを実行して ADB を再起動してみてください。

3. 「複数のデバイスが接続されています」というエラー

   • ツール呼び出しでdevice_idパラメータを指定します

   • adb_devicesツールで利用可能なデバイスのリストを取得する

4. クリップボードへのスクリーンショットが機能しない

   • 必要なプラットフォーム固有のツールがインストールされていることを確認する

🔧 代替インストール方法

オプション1: npmからインストールする

# Install globally
npm install -g @landicefu/android-adb-mcp-server

# Or install locally in your project
npm install @landicefu/android-adb-mcp-server

オプション2: ソースからの手動インストール

1. リポジトリをクローンします。

   git clone https://github.com/landicefu/android-adb-mcp-server.git
   cd android-adb-mcp-server

2. 依存関係をインストールしてビルドします。

   npm install
   npm run build

3. 直接パスで構成します:

   {
     "mcpServers": {
       "android-adb": {
         "command": "node",
         "args": ["/path/to/android-adb-mcp-server/build/index.js"],
         "env": {},
         "disabled": false,
         "alwaysAllow": []
       }
     }
   }

📄 ライセンス

このプロジェクトは ISC ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

🤝 貢献する

貢献を歓迎します！お気軽にプルリクエストを送信してください。

1. リポジトリをフォークする

2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）

3. 変更をコミットします ( git commit -m 'Add some amazing feature' )

4. ブランチにプッシュする ( git push origin feature/amazing-feature )

5. プルリクエストを開く