Mcp Android Adb Server

🚀 mcp-android-adb-server

ADB を介して Android デバイスを操作するための MCP サービスです。

2025-04-01: qwen2.5-vl などの視覚モデルを使用して画面の説明内容を取得する機能を追加しました。

手動インストール

# clone the repo and build
git clone https://github.com/github-hewei/mcp-android-adb-server.git
cd mcp-android-adb-server
go build

設定

{
  "mcpServers": {
    "mcp-android-adb-server": {
      "command": "D:\\www\\golang\\mcp-android-adb-server\\mcp-android-adb-server.exe",
      "env": {
        "DEVICE_ID": "xxxxx",
        "SCREEN_LOCK_PASSWORD": "123456",
        "VISUAL_MODEL_ON": "true",
        "VISUAL_MODEL_API_KEY": "sk-or-xxxxxxxxxxxxxxxxxxx",
        "VISUAL_MODEL_BASE_URL": "https://openrouter.ai/api/v1/",
        "VISUAL_MODEL_NAME": "qwen/qwen2.5-vl-72b-instruct:free"
      }
    }
  }
}

環境変数

• DEVICE_ID : 必須。Android デバイスの ID で、adb devices コマンドで取得できます。
• SCREEN_LOCK_PASSWORD : オプション。デバイスの画面ロックパスワードで、画面のロック解除に使用します。
• VISUAL_MODEL_ON : オプション。視覚モデルを有効にするかどうか。デフォルトは false です。
• VISUAL_MODEL_API_KEY : API Key。
• VISUAL_MODEL_BASE_URL : API Base URL。
• VISUAL_MODEL_NAME : モデル名。

機能とツール

アプリケーション管理

• install_app : Android デバイスにアプリケーションをインストールします
• uninstall_app : Android デバイスからアプリケーションをアンインストールします
• terminate_app : Android デバイスで実行中のアプリケーションを終了します
• launch_app : Android デバイスでアプリケーションを起動します
• list_app : Android デバイスにインストールされているすべてのアプリケーションを一覧表示します
• is_app_installed : 特定のアプリケーションがインストールされているかどうかを確認します

画面制御

• unlock_screen : Android デバイスの画面をロック解除します
• lock_screen : Android デバイスの画面をロックします
• is_screen_locked : Android デバイスの画面がロックされているかどうかを確認します
• is_screen_active : Android デバイスの画面がアクティブかどうかを確認します

入力制御

• input_text : Android デバイスでテキストを入力します
• input_key : Android デバイスでキー入力を送信します
• tap : 画面の指定した位置をタップする操作を実行します
• long_tap : 画面の指定した位置を長押しする操作を実行します
• back : 戻る操作を実行します

ジェスチャー制御

• swipe_up : Android デバイスの画面で上方向へのスワイプジェスチャーを実行します
• swipe_down : Android デバイスの画面で下方向へのスワイプジェスチャーを実行します
• swipe_left : Android デバイスの画面で左方向へのスワイプジェスチャーを実行します
• swipe_right : Android デバイスの画面で右方向へのスワイプジェスチャーを実行します

デバイス情報

• screen_size : Android デバイスの画面サイズを取得します
• screen_dpi : Android デバイスの画面 DPI を取得します
• screenshot_description : Android デバイスのスクリーンショットの説明を取得します
• system_info : Android デバイスのシステム情報を取得します

その他の機能

• shell_command : Android デバイスでシェルコマンドを実行します