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 Toolkit

📋 前提条件

**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デバイスでアプリケーションを起動する
スクリーンショットを撮ってローカルに保存するか、クリップボードにコピーします
複数のデバイスが接続されている場合のスマートデバイスの選択

🛠️ 利用可能なツール

道具	説明	必須パラメータ	オプションパラメータ
`adb_devices`	接続されているデバイスの一覧	なし	なし
`adb_shell`	シェルコマンドを実行する	`command`	`device_id`
`adb_install`	APKファイルをインストールする	`path`	`device_id`
`adb_uninstall`	アプリケーションをアンインストールする	`package_name`	`device_id`
`adb_list_packages`	インストールされたパッケージの一覧	なし	`device_id` 、 `filter`
`adb_pull`	デバイスからファイルを取得する	`remote_path` 、 `local_path`	`device_id`
`adb_push`	ファイルをデバイスにプッシュする	`local_path` 、 `remote_path`	`device_id`
`launch_app`	アプリケーションを起動する	`package_name`	`device_id`
`take_screenshot_and_save`	スクリーンショットを撮って保存する	`output_path`	`device_id` 、 `format`
`take_screenshot_and_copy_to_clipboard`	スクリーンショットをクリップボードに保存する	なし	`device_id` 、 `format`

デバイス管理

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

接続されているデバイスが1つだけの場合は、自動的に使用されます
複数のデバイスが接続されている場合は、 device_idパラメータを指定する必要があります。
デバイスが接続されていない場合はエラーが返されます

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

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

絶対パスはそのまま使用されます
~で始まるパスはユーザーのホームディレクトリに展開されます
相対パスはユーザーのホームディレクトリを基準に解決されます

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

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

よくある問題

「ADBは利用できません」というエラー
- ADBがインストールされ、システムPATHに含まれていることを確認してください
- ターミナルでadb versionを実行して確認します
「Androidデバイスが接続されていません」というエラー
- デバイスがadb devicesに正しく接続されているか確認してください
- デバイスでUSBデバッグが有効になっていることを確認してください
- adb kill-serverとadb start-serverを実行して ADB を再起動してみてください。
「複数のデバイスが接続されています」というエラー
- ツール呼び出しでdevice_idパラメータを指定します
- adb_devicesツールで利用可能なデバイスのリストを取得する
クリップボードへのスクリーンショットが機能しない
- 必要なプラットフォーム固有のツールがインストールされていることを確認する

🔧 代替インストール方法

オプション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: ソースからの手動インストール

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

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

依存関係をインストールしてビルドします。
```
npm install
npm run build
```

直接パスで構成します:

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

📄 ライセンス

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

🤝 貢献する

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

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

Android ADB MCP Server