Android MCP

🚀 🤖 Android MCP

Android-MCP 是一個輕量級的開源橋樑，用於連接 AI 智能體和 Android 設備。它以 MCP 服務器的形式運行，能讓大語言模型智能體執行諸如應用導航、UI 交互和自動化 QA 測試等實際任務，且無需依賴傳統的計算機視覺流程或預編程腳本。

https://github.com/user-attachments/assets/cf9a5e4e-b69f-46d4-8487-0f61a7a86d67

🚀 快速開始

Android-MCP 是連接 AI 智能體與 Android 設備的關鍵工具。以下將詳細介紹如何安裝和配置它，以便你能儘快開始使用。

✨ 主要特性

• 原生 Android 集成
  通過 ADB 和 Android 輔助功能 API 與 UI 元素進行交互，可實現啟動應用、點擊、滑動、輸入文本以及讀取視圖層次結構等操作。
• 支持自定義大語言模型/視覺語言模型
  可與任何語言模型配合使用，無需微調的計算機視覺模型或 OCR 流程。
• 豐富的移動自動化工具集
  提供預構建的工具，用於處理手勢、按鍵、屏幕捕獲、設備狀態以及執行 shell 命令。
• 實時交互
  根據設備規格和負載情況，操作（如兩次點擊）之間的典型延遲範圍為 2 - 4 秒。

支持的操作系統

• Android 10 及以上版本

📦 安裝指南

📦 前提條件

• Python 3.10 及以上版本
• UIautomator2
• Android 模擬器/Android 設備

🏁 開始安裝

1. 克隆倉庫

git clone https://github.com/CursorTouch/Android-MCP.git
cd Android-MCP

2. 安裝依賴項

uv python install 3.10
uv sync

3. 連接到 MCP 服務器
   1. 找到你的 Claude Desktop 配置文件：
      • Windows：%APPDATA%\Claude\claude_desktop_config.json
      • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   2. 將以下 JSON 添加到你的 Claude Desktop 配置中：

{
    "mcpServers": {
        "android-mcp": {
            "command": "path/to/uv",
            "args": [
                "--directory",
                "path/to/Android-MCP",
                "run",
                "main.py",
                "--emulator"
            ]
        }
    }
}

替換以下內容：
- `path/to/uv` 替換為你的 uv 可執行文件的實際路徑
- `path/to/Android-MCP` 替換為你克隆此倉庫的絕對路徑

注意：`--emulator` 用於在模擬器中運行，若要使用實際設備，請移除該參數。

3. 重啟 Claude Desktop 打開你的 Claude Desktop，“android-mcp” 現在應該會作為一個集成項出現。

如需查看故障排除提示（日誌位置、常見 ADB 問題），請參閱 MCP 文檔。

💻 使用示例

Claude 可以使用以下工具與 Android 設備進行交互：

• State-Tool：瞭解設備的狀態。
• Click-Tool：在給定座標處點擊屏幕。
• Long-Click-Tool：在給定座標處長按屏幕。
• Type-Tool：在指定座標處輸入文本（可選擇清除現有文本）。
• Swipe-Tool：從一個位置滑動到另一個位置。
• Drag-Tool：從一個點拖動到另一個點。
• Press-Tool：按下移動設備上的按鍵（返回、音量增大等）。
• Wait-Tool：暫停指定的持續時間。
• State-Tool：獲取活動應用和交互式 UI 元素的組合快照。
• Notification-Tool：訪問設備上顯示的通知。
• Shell-Tool：在 Android 設備上執行 shell 命令。

⚠️ 重要提示

⚠️ 重要提示

Android-MCP 可以在你的移動設備上執行任意 UI 操作。在運行不可信的提示或智能體時，請在受控環境（模擬器、測試設備）中使用。

📄 許可證

本項目採用 MIT 許可證。詳情請參閱 LICENSE。

🤝 貢獻說明

歡迎貢獻代碼！請閱讀 CONTRIBUTING 瞭解開發環境設置和 PR 指南。

由 Jeomon George 用心打造

引用

@misc{
  author       = {Jeomon George},
  title        = {Android-MCP},
  year         = {2025},
  publisher    = {GitHub},
  howpublished = {\url{https://github.com/CursorTouch/Android-MCP}},
  note         = {Lightweight open-source bridge between LLM agents and Android},
}