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 アシスタントを再起動して新しいサーバー設定を読み込みます。

📋 前提条件

**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 )
プルリクエストを開く

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

AI アシスタントが ADB を介して Android デバイスと対話できるようにし、自動化されたデバイス管理、アプリのインストール、ファイル転送、スクリーンショットのキャプチャを可能にするモデルコンテキストプロトコルサーバー。

Related MCP Servers

DroidMind
hyperb1iss
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that enables AI assistants to control and interact with Android devices, allowing for device management, app debugging, system analysis, and UI automation through natural language commands.
Last updated -
29
198
Python
Apache 2.0
MCP Toolkit
zxfgds
-
security
F
license
-
quality
A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
Last updated -
3
1
TypeScript
MCP Android Agent
nim444
-
security
A
license
-
quality
A Model Context Protocol server that enables AI agents to control and automate Android devices through natural language, supporting actions like app management, UI interactions, and device monitoring.
Last updated -
16
Python
MIT License
AndroidTVMCP
pigeek
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants to control Android TV devices, providing remote control functionality like navigation, playback control, app management, and device status monitoring.
Last updated -
4
Python
MIT License

View all related MCP servers

Android ADB MCP Server