MCP Android Adb Server

🚀 mcp-android-adb-server

このMCPサービスは、adbを通じてAndroidデバイスを操作するために使用されます。

2025年4月1日：qwen2.5-vlなどのビジュアルモデルを使用して画面の説明内容を取得する機能を追加しました。

🚀 クイックスタート

📦 インストール

手動インストール

# リポジトリをクローンしてビルド
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"
      }
    }
  }
}

環境変数

✨ 主な機能

アプリケーション管理

• 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デバイス上でshellコマンドを実行します。