Android Debug Bridge

🚀 Android MCP 服務器

Android MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，藉助 Android Debug Bridge (ADB) 實現對安卓設備的程序化控制。它提供了豐富的安卓設備管理功能，可通過 MCP 客戶端（如 Claude 桌面）和代碼編輯器（如 Cursor）進行訪問。

🚀 快速開始

在使用 Android MCP 服務器之前，你需要完成一系列的準備工作，包括安裝必要的軟件和配置服務器。

✨ 主要特性

• 🔧 執行 ADB 命令：可直接在服務器端對安卓設備執行各種 ADB 命令。
• 📸 截取設備屏幕截圖：方便獲取設備當前的屏幕畫面。
• 🎯 分析用戶界面佈局：對設備的界面佈局進行詳細分析。
• 📱 管理設備軟件包：實現對設備上軟件包的管理操作。

📦 安裝指南

先決條件

• Python 3.x
• 已安裝並配置 Android Debug Bridge (ADB)
• 安卓設備或模擬器（未經過測試）

安裝步驟

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）指定目標安卓設備。

自定義配置

1. 創建新配置文件：

touch config.yaml

2. 配置您的設備：

device:
  name: "google-pixel-7-pro:5555" # 您的設備標識符，來自 'adb devices'

使用方法

需要 MCP 客戶端才能使用此服務器。Claude Desktop 應用是一個例子。要與 Claude Desktop 一起使用此服務器：

1. 找到您的 Claude Desktop 配置文件位置：
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
2. 在 mcpServers 部分添加 Android MCP 服務器配置：

{
  "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 您克隆此倉庫的實際絕對路徑

GitHub 資源附加

💻 使用示例

基礎用法

服務器公開了以下工具，以下是各工具的使用示例：

def get_packages() -> str:
    """
    獲取設備上所有已安裝的軟件包。
    返回：
        str：設備上所有已安裝軟件包的字符串列表
    """

def execute_adb_command(command: str) -> str:
    """
    執行 ADB 命令並返回輸出。
    參數：
        command (str)：要執行的命令
    返回：
        str：命令的輸出結果
    """

def get_window_bounds(package_name: str, activity_name: str) -> tuple[int, int, int, int]:
    """
    獲取指定應用程序窗口的邊界座標。
    參數：
        package_name (str)：應用程序包名
        activity_name (str)：活動名稱
    返回：
        tuple[int, int, int, int]：左上角 x，左上角 y，右下角 x，右下角 y 的元組
    """

def get_window_size(package_name: str, activity_name: str) -> tuple[int, int]:
    """
    獲取指定應用程序窗口的大小。
    參數：
        package_name (str)：應用程序包名
        activity_name (str)：活動名稱
    返回：
        tuple[int, int]：窗口寬度和高度的元組
    """

def get_display_metrics(package_name: str, activity_name: str) -> dict:
    """
    獲取指定應用程序窗口的顯示指標。
    參數：
        package_name (str)：應用程序包名
        activity_name (str)：活動名稱
    返回：
        dict：包含密度、寬度和高度等信息的字典
    """

def get_views(package_name: str, activity_name: str) -> list:
    """
    獲取指定應用程序窗口中的所有視圖。
    參數：
        package_name (str)：應用程序包名
        activity_name (str)：活動名稱
    返回：
        list：包含視圖信息的列表
    """

🤝 貢獻

如需貢獻，請參考項目倉庫 GitHub。

🙏 致謝

感謝您使用此項目！如遇問題或有任何建議，請隨時提出。