Minhalvp Android MCP Server

🚀 Android MCP 服務器

Android MCP 服務器是一個藉助 ADB（Android 調試橋接）實現對安卓設備進行程序化控制的 MCP (模型上下文協議) 服務器。它提供了豐富的安卓設備管理功能，可通過 MCP 客戶端（如 Claude 桌面）和代碼編輯器（如 Cursor）進行訪問。

✨ 主要特性

• 🔧 可執行 ADB 命令
• 📸 能捕獲設備屏幕截圖
• 🎯 支持分析 UI 佈局
• 📱 可管理設備包

📦 安裝指南

先決條件

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

安裝步驟

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 桌面應用是一個例子。要與 Claude 桌面一起使用此服務器：

1. 找到你的 Claude 桌面配置文件：
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
2. 將 Android MCP 服務器配置添加到 mcpServers 部分：

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

可用工具

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

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

def analyze_ui_layout() -> None:
    """
    分析並捕獲當前設備的 UI 佈局。
    """

def get_screen_shot() -> Image:
    """
    捕獲設備屏幕截圖並返回為 Image 對象。
    返回：
        Image: 屏幕截圖的 Image 對象
    """

🤝 貢獻

我們歡迎社區貢獻！如果你有任何問題或建議，請隨時在 GitHub 提交問題或拉取請求。

🙏 致謝

感謝你使用 Android MCP 服務器。此項目基於 MCP 協議 開發，旨在為安卓設備提供更強大的控制和管理能力。