什麼是MCP Android ADB Server?

MCP Android ADB Server是一款基於MCP協議的服務，通過ADB（Android Debug Bridge）連接和控制安卓設備。它可以幫助用戶輕鬆實現屏幕控制、應用管理以及設備信息獲取等功能。

如何使用MCP Android ADB Server?

只需幾步即可完成安裝和配置，隨後即可通過簡單的命令控制您的安卓設備。

適用場景

適用於需要遠程操作安卓設備的場景，例如自動化測試、遠程調試或娛樂互動。

主要功能

應用管理包括安裝、卸載、啟動、終止和列出所有已安裝的應用程序。

屏幕控制支持解鎖、鎖定屏幕，檢查屏幕狀態，以及執行滑動手勢。

輸入控制允許在設備上輸入文本、模擬按鍵點擊或長按。

手勢控制支持向上、向下、向左、向右滑動等常見手勢。

設備信息獲取屏幕分辨率、DPI、系統信息及屏幕截圖描述。

Shell命令執行可在設備上直接執行自定義Shell命令。

視覺模型支持新增功能：利用視覺模型（如Qwen2.5-VL）生成屏幕截圖的描述內容。

優勢與侷限性

優勢

功能全面，覆蓋多種設備操作需求。

支持視覺模型增強用戶體驗。

易於集成到現有系統中。

侷限性

需要設備具備ADB調試模式開啟。

某些高級功能可能對設備性能有一定影響。

如何使用

下載與安裝

克隆項目代碼並編譯生成可執行文件。

配置環境變量

設置必要的環境變量，如設備ID、屏幕密碼等。

啟動服務

運行編譯後的可執行文件。

使用案例

案例1：啟動應用程序啟動設備上的微信應用程序。

案例2：生成屏幕截圖描述獲取當前屏幕截圖並生成自然語言描述。

常見問題

如何確保設備與服務器正常連接？

為什麼無法安裝某些應用程序？

🚀 mcp-android-adb-server

一個MCP服務，可藉助adb對安卓設備進行操作。該服務於2025年4月1日新增支持，能夠使用像qwen2.5-vl這樣的視覺模型來獲取屏幕描述內容。

🚀 快速開始

本項目是一個MCP服務，用於通過adb操作安卓設備，下面為你介紹其安裝、配置等使用步驟。

📦 安裝指南

手動安裝

# 克隆倉庫並構建
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密鑰。
VISUAL_MODEL_BASE_URL	API BaseURL。
VISUAL_MODEL_NAME	模型名稱。