Minhalvp Android MCP Server

🚀 Android MCP サーバー

このサーバーは、ADB（Android デバッグブリッジ）を通じて Android デバイスのプログラムによる制御を可能にする MCP（モデルコンテキストプロトコル）サーバーです。様々な Android デバイス管理機能を公開しており、MCP クライアント（例：Claude デスクトップ）やコードエディタ（例：Cursor）からアクセスできます。

✨ 主な機能

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

📦 インストール

前提条件

• Python 3.x
• インストールおよび設定済みの ADB (Android Debug Bridge)
• 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 デスクトップアプリはその一例です。Claude デスクトップとともにこのサーバーを使用するには：

1. Claude デスクトップの構成ファイルを見つけます：
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
2. Android MCP サーバーの構成を mcpServers セクションに追加します：

{
  "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 はこのリポジトリをクローンした実際の絶対パス

利用可能なツール

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

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

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

def analyze_ui_layout() -> None:
    """
    現在のデバイスの UI レイアウトを分析してキャプチャします。
    """

def get_screen_shot() -> Image:
    """
    デバイスのスクリーンショットを取得し、Image オブジェクトとして返します。
    戻り値:
        Image: スクリーンショットの Image オブジェクト
    """

🤝 貢献

コミュニティからの貢献を歓迎します！何か問題や提案があれば、GitHub で問題を提出したり、プルリクエストを送信したりしてください。

📄 ライセンス

Android MCP サーバーをご利用いただき、ありがとうございます。このプロジェクトは MCP プロトコル に基づいて開発されており、Android デバイスのより強力な制御と管理機能を提供することを目的としています。