Android Debug Bridge

🚀 Android MCP サーバー

このサーバーは、Android Debug Bridge (ADB) を通じて、Android デバイスのプログラムによる制御を可能にする Model Context Protocol (MCP) サーバーです。MCP クライアント（例：Claude デスクトップ）やコードエディタ（例：Cursor）からアクセスでき、様々な Android デバイス管理機能を提供します。

✨ 主な機能

• 🔧 ADB コマンドの実行
• 📸 デバイスのスクリーンショットの取得
• 🎯 ユーザーインターフェイスレイアウトの分析
• 📱 デバイスのソフトウェアパッケージの管理

📦 インストール

前提条件

• Python 3.x
• Android Debug Bridge (ADB) がインストールされ、設定されていること
• Android デバイスまたはエミュレータ（未テスト）

インストール手順

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

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

2. 依存関係をインストールします： このプロジェクトでは、uv を使ってプロジェクト管理を行っており、複数の方法でインストールできます。

uv python install 3.11
uv sync

📚 ドキュメント

設定

サーバーは、簡単な YAML 設定ファイル（config.yaml）を使って、ターゲットの Android デバイスを指定します。

カスタム設定

1. 新しい設定ファイルを作成します：

touch config.yaml

2. デバイスを設定します：

device:
  name: "google-pixel-7-pro:5555" # あなたのデバイス識別子（'adb devices' から取得）

使用方法

このサーバーを使用するには、MCP クライアントが必要です。Claude Desktop アプリがその一例です。Claude Desktop とともにこのサーバーを使用するには：

1. Claude Desktop の設定ファイルの場所を見つけます：
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
2. mcpServers セクションに Android MCP サーバーの設定を追加します：

{
  "mcpServers": {
    "android": {
      "command": "path/to/uv",
      "args": ["--directory", "path/to/android-mcp-server", "run", "server.py"]
    }
  }
}

以下の内容を置き換えてください：

• path/to/uv：あなたの実際の uv 実行ファイルのパス
• path/to/android-mcp-server：あなたがこのリポジトリをクローンした実際の絶対パス

GitHub リソース添付

利用可能なツール

サーバーは以下のツールを公開しています：

def get_packages() -> str:
    """
    デバイス上のすべてのインストール済みソフトウェアパッケージを取得します。
    戻り値:
        str: デバイス上のすべてのインストール済みパッケージの文字列リスト
    """

def execute_adb_command(command: str) -> str:
    """
    ADB コマンドを実行し、出力を返します。
    引数:
        command (str): 実行するコマンド
    戻り値:
        str: コマンドの出力結果
    """

def get_window_bounds(package_name: str, activity_name: str) -> tuple[int, int, int, int]:
    """
    指定されたアプリケーションウィンドウの境界座標を取得します。
    引数:
        package_name (str): アプリケーションのパッケージ名
        activity_name (str): アクティビティ名
    戻り値:
        tuple[int, int, int, int]: 左上の x、左上の y、右下の x、右下の y のタプル
    """

def get_window_size(package_name: str, activity_name: str) -> tuple[int, int]:
    """
    指定されたアプリケーションウィンドウのサイズを取得します。
    引数:
        package_name (str): アプリケーションのパッケージ名
        activity_name (str): アクティビティ名
    戻り値:
        tuple[int, int]: ウィンドウの幅と高さのタプル
    """

def get_display_metrics(package_name: str, activity_name: str) -> dict:
    """
    指定されたアプリケーションウィンドウの表示メトリクスを取得します。
    引数:
        package_name (str): アプリケーションのパッケージ名
        activity_name (str): アクティビティ名
    戻り値:
        dict: 密度、幅、高さなどの情報を含む辞書
    """

def get_views(package_name: str, activity_name: str) -> list:
    """
    指定されたアプリケーションウィンドウ内のすべてのビューを取得します。
    引数:
        package_name (str): アプリケーションのパッケージ名
        activity_name (str): アクティビティ名
    戻り値:
        list: ビュー情報を含むリスト
    """

貢献

貢献する場合は、プロジェクトリポジトリ GitHub を参照してください。

📄 ライセンス

ありがとうございます！問題が発生した場合や、何か提案がある場合は、いつでもご連絡ください。