Provides tools to control and automate Android devices through uiautomator2, enabling app management, UI interactions (tapping, swiping, scrolling), screenshot capture, device monitoring, and more
Supports integration with GitHub Copilot Chat, allowing it to control Android devices and perform automation tasks through natural language
このプロジェクトは、 uiautomator2を用いてAndroidデバイスを自動化するための**MCP（Model Context Protocol）**サーバーを提供します。GitHub Copilot Chat、Claude、Open InterpreterなどのAIエージェントに簡単に接続でき、自然言語でAndroidデバイスを制御できるように設計されています。
adb診断ツールが含まれています最適な用途:
このサーバーを使用するには、MCPクライアントが必要です。Claude DesktopアプリはMCPクライアントの一例です。Claude Desktopでこのサーバーを使用するには、以下の手順に従ってください。
%APPDATA%\Claude\claude_desktop_config.json~/Library/Application Support/Claude/claude_desktop_config.json/path/to/mcp-adbこのリポジトリをクローンした場所の絶対パスに置き換えます。例: /Users/username/Projects/mcp-adb
このMCPサーバーはVS Codeのエージェントモード（VS Code 1.99以降が必要）でも使用できます。設定手順は以下のとおりです。
.vscode/mcp.jsonファイルを作成します。/path/to/mcp-adbを、このリポジトリのクローンを作成した場所への絶対パスに置き換えます。
構成を追加したら、以下を使用してサーバーを管理できます。
MCP: List Servers 、構成されたサーバーを表示および管理します。MCP: Start Serverでサーバーを起動しますこのプロジェクトには、デバイスのインターフェース構造を表示および分析するための強力な UI 検査ツールである uiauto.dev のサポートが含まれています。
| ツール名 | 説明 |
|---|---|
mcp_health | MCPサーバーが正常に動作しているかどうかを確認する |
connect_device | Androidデバイスに接続して基本情報を取得する |
get_installed_apps | インストールされているすべてのアプリをバージョンとパッケージ情報とともに一覧表示します |
get_current_app | 現在フォアグラウンドにあるアプリの情報を取得します |
start_app | パッケージ名でアプリを起動する |
stop_app | パッケージ名でアプリを停止する |
stop_all_apps | 現在実行中のアプリをすべて停止する |
screen_on | 画面をオンにする |
screen_off | 画面をオフにする |
get_device_info | 詳細なデバイス情報を取得します: シリアル、解像度、バッテリーなど。 |
press_key | ハードウェアキーの押下をシミュレートします (例: home 、 back 、 menuなど) |
unlock_screen | 画面のロックを解除します（必要に応じて電源を入れてスワイプします） |
check_adb | ADBがインストールされているかどうかを確認し、接続されているデバイスを一覧表示します |
wait_for_screen_on | 画面がオンになるまで非同期に待機します |
click | text 、 resourceId 、またはdescriptionで要素をタップします |
long_click | 要素を長押しする |
send_text | 現在フォーカスされているフィールドにテキストを入力します（オプションでその前にクリア） |
get_element_info | UI 要素 (テキスト、境界、クリック可能など) に関する情報を取得します。 |
swipe | ある座標から別の座標へスワイプする |
wait_for_element | 要素が画面に表示されるまで待つ |
screenshot | デバイスからスクリーンショットを撮って保存する |
scroll_to | 特定の要素が表示されるまでスクロールします |
drag | 要素を特定の画面位置にドラッグする |
get_toast | 画面に表示された最後のトーストメッセージを取得する |
clear_app_data | 指定したアプリのユーザーデータ/キャッシュを消去する |
wait_activity | 特定のアクティビティが表示されるまで待つ |
dump_hierarchy | 現在の画面の UI 階層を XML としてダンプします。 |
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
AI エージェントが自然言語を通じて Android デバイスを制御および自動化し、アプリ管理、UI 操作、デバイス監視などのアクションをサポートできるようにするモデル コンテキスト プロトコル サーバー。