Adb MCP

🚀 ADB MCP

ADB MCP 是一個模型上下文協議（MCP）服務器，為自動化安卓設備提供安卓調試橋（ADB）功能，可實現設備管理、屏幕操作、應用管理等一系列自動化操作。

✨ 主要特性

設備管理

• 列出已連接的設備
• 獲取設備信息
• 設置操作的默認設備
• 檢查設備連接狀態

屏幕操作

• 截取屏幕截圖
• 在指定座標處點擊
• 執行滑動手勢
• 輸入文本
• 按下按鍵

應用管理

• 安裝/卸載應用
• 啟動/停止應用
• 列出已安裝的應用
• 獲取應用信息

文件操作

• 將文件推送到設備
• 從設備拉取文件
• 列出文件和目錄
• 創建目錄
• 刪除文件

執行 shell 命令

• 執行 shell 命令
• 獲取系統信息
• 獲取電池信息
• 獲取日誌輸出

📦 安裝指南

1. 克隆倉庫
2. 安裝依賴：

   npm install
   

3. 構建項目：

   npm run build
   

💻 使用示例

前提條件

• 必須安裝安卓調試橋（adb），並且其可在系統的 PATH 中找到
• 通過 USB 連接安卓設備，並啟用 USB 調試功能
• 設備必須被授權進行調試

啟動服務器

npm start

可用工具

設備管理

• adb_list_devices - 列出所有已連接的設備
• adb_get_device_info - 獲取設備信息
• adb_set_default_device - 設置默認設備

屏幕操作

• adb_screenshot - 截取屏幕截圖
• adb_click - 在指定座標處點擊
• adb_swipe - 執行滑動手勢
• adb_input_text - 輸入文本
• adb_press_key - 按下按鍵

應用管理

• adb_install_app - 安裝 APK
• adb_uninstall_app - 卸載應用
• adb_start_app - 啟動應用
• adb_stop_app - 停止應用
• adb_list_apps - 列出已安裝的應用

文件操作

• adb_push_file - 將文件推送到設備
• adb_pull_file - 從設備拉取文件
• adb_list_files - 列出目錄中的文件

執行 shell 命令

• adb_shell - 執行 shell 命令
• adb_get_system_info - 獲取系統信息
• adb_get_battery_info - 獲取電池信息
• adb_get_logcat - 獲取日誌輸出

🔧 技術細節

服務器包含以下基本安全措施：

• 阻止危險的 shell 命令
• 進行文件路徑驗證
• 驗證設備連接
• 對輸入進行清理

📚 詳細文檔

構建

npm run build

開發模式

npm run dev

代碼檢查

npm run lint

MCP

      "mcpServers": {
        "adb-mcp": {
          "type": "stdio",
          "command": "node",
          "args": [
            "/adb-mcp/dist/index.js"
          ],
          "env": {
            "ADB_DOWNLOAD_PATH": "/adb-mcp",
            "MCP_READ_PATH": "/adb-mcp"
          }
        }
      }

📄 許可證

本項目採用 MIT 許可證。