MCP Android Adb Server

一個通過adb操作安卓設備的MCP服務，支持應用管理、屏幕控制、輸入手勢和設備信息獲取等功能，並可集成視覺模型進行屏幕內容分析。

開發者工具操作系統自動化 #安卓控制 #ADB工具 #視覺模型 .Go

評分 : 2.5分

下載量 : 11.9K

更新時間 : 2025-04-28

打開站點

什麼是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	模型名稱。