Adb MCP

🚀 ADB MCP 服務器

ADB MCP 服務器是一款基於 TypeScript 的工具，它藉助 Android Debug Bridge (ADB) 實現與安卓設備的交互。該工具在 AI 模型和安卓設備功能之間搭建了一座橋樑，為相關開發和測試工作提供了便利。

🚀 快速開始

在使用 ADB MCP 服務器之前，請確保滿足以下先決條件：

• Node.js（建議 v16 或更高版本，已測試過 Node.js v16、v18 和 v20）
• 已安裝並配置 PATH 環境變量的 ADB (Android Debug Bridge)
• 通過 USB 或網絡連接到計算機且啟用了 USB 調試模式的安卓設備或模擬器
• 訪問設備的權限（已接受調試授權）

✨ 主要特性

• 📱 設備管理：可列出並操作連接的安卓設備。
• 📦 應用安裝：能將 APK 文件部署到連接的設備上。
• 📋 日誌記錄：可通過 logcat 訪問設備的日誌信息。
• 🔄 文件傳輸：支持在設備與主機之間推送和拉取文件。
• 📸 UI 交互：能夠捕獲屏幕截圖並分析 UI 層次結構。
• 🔧 Shell 命令執行：可在設備上運行自定義命令。

📦 安裝指南

# 克隆倉庫
git clone https://github.com/srmorete/adb-mcp.git
cd adb-mcp

# 安裝依賴項
npm install

# 構建 TypeScript 代碼
npm run build

# 運行服務器
npx adb-mcp

📚 詳細文檔

配置

ADB 路徑配置

服務器默認使用 ADB 的默認路徑。若需指定自定義路徑，可按如下操作：

export ADB_PATH=/path/to/adb
npx adb-mcp

MCP 配置

添加 ADB MCP 服務器配置：

{
  "mcpServers": {
    "adb": {
      "command": "npx",
      "args": [
        "adb-mcp"
      ]
    }
  }
}

使用方法

啟動服務器

注意：使用任何 ADB 工具之前，必須確保服務器已啟動。 使用以下命令啟動服務器：

npx adb-mcp

你應該會看到如下輸出：

[INFO] ADB MCP 服務器連接並準備就緒

在運行 ADB 工具時，請保持此終端窗口打開。

可用工具

• 設備管理：用於列出和操作連接的安卓設備。
• 應用安裝：將 APK 文件部署到連接的設備上。
• 日誌記錄：通過 logcat 訪問設備的日誌信息。
• 文件傳輸：在設備與主機之間推送和拉取文件。
• UI 交互：捕獲屏幕截圖並分析 UI 層次結構。
• Shell 命令執行：在設備上運行自定義命令。

故障排除

服務器問題

如果無法啟動服務器，請檢查 Node.js 和 npm 是否正確安裝，並確保已安裝所有依賴項。

設備連接問題

• 確保設備通過 USB 或網絡正確連接到計算機。
• 檢查設備是否啟用了 USB 調試模式。

日誌記錄問題

如果無法查看日誌，請檢查 logcat 是否正確配置，並確保設備已連接。

兼容性

• 支持的安卓版本：所有支持 ADB 的安卓系統。
• 支持的操作系統：Windows、Linux 和 macOS。

貢獻指南

如何貢獻

• 提交問題和建議到 GitHub 倉庫。
• 創建拉取請求修復問題或添加功能。

📄 許可證

此項目遵循 [LICENSE] 協議。