MCP Adb

🚀 MCP-ADB

MCP-ADB是一個模型上下文協議（MCP）服務器，它與Android調試橋接（ADB）集成，讓AI助手能夠與Android設備進行交互。

🚀 快速開始

MCP-ADB可使AI助手與Android設備交互。使用前，你需要完成環境準備和項目安裝。

✨ 主要特性

• 截圖捕獲：獲取連接的Android設備屏幕截圖，並自動調整大小。
• Base64圖像數據：直接接收屏幕截圖數據作為Base64編碼字符串。
• 按鍵事件控制：向Android設備發送鍵事件（導航、返回、主頁）。
• 多設備支持：在多個設備連接時指定目標設備。
• 設備列表：列出所有連接的Android設備作為資源。
• 資源訪問：通過資源URI訪問屏幕截圖和設備信息。

📦 安裝指南

先決條件

• Node.js（推薦v16或更高版本）
• Android調試橋接（ADB）已安裝並添加到PATH環境變量，或通過ADB_PATH環境變量配置。
• 已連接的Android設備，且USB調試功能已啟用。

安裝步驟

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

# 安裝依賴項
npm install

# 構建項目
npm run build

💻 使用示例

與Claude Desktop一起使用

要將此MCP服務器與Claude Desktop一起使用，請在claude_desktop_config.json文件中添加mcp-adb配置，該文件位於Claude Desktop安裝目錄或通過Claude - 設置 - 開發人員 - 編輯配置找到。

以下是一個配置示例：

{
  "mcpServers": {
    "mcp-adb": {
      "command": "node",
      "args": ["/path/to/mcp-adb/build/index.js"],
      "env": {
        "ADB_PATH": "/path/to/adb"
      }
    }
  }
}

可用工具

截圖工具

從連接的Android設備捕獲屏幕截圖並自動調整大小到640px寬度。

參數：

• deviceId（可選）：指定目標設備，當有多個設備連接時使用。

響應：

• 直接在響應中返回Base64編碼的圖像數據（PNG格式）。

示例：

{
  "name": "screenshot",
  "arguments": {
    "deviceId": "emulator-5554"
  }
}

按鍵按下工具

向連接的Android設備發送一個按鍵事件。

參數：

• keycode：要發送的Android按鍵代碼（參見下方列表）。
• deviceId（可選）：指定目標設備，當有多個設備連接時使用。

可用按鍵代碼：

• KEYCODE_DPAD_CENTER - 中心/確定按鈕
• KEYCODE_DPAD_DOWN - 下導航鍵
• KEYCODE_DPAD_UP - 上導航鍵
• KEYCODE_DPAD_LEFT - 左導航鍵
• KEYCODE_DPAD_RIGHT - 右導航鍵
• KEYCODE_DPAD_UP_LEFT - 對角線上行左
• KEYCODE_DPAD_UP_RIGHT - 對角線上行右
• KEYCODE_DPAD_DOWN_LEFT - 對角線下行左
• KEYCODE_DPAD_DOWN_RIGHT - 對角線下行右
• KEYCODE_HOME - 主頁面鍵
• KEYCODE_BACK - 返回鍵

示例：

{
  "name": "keyDown",
  "arguments": {
    "deviceId": "emulator-5554",
    "keyCode": "KEYCODE_HOME"
  }
}

📚 詳細文檔

資源URI訪問

通過以下URI格式可以訪問資源：

• mctp://<host>:<port>/screenshot - 獲取屏幕截圖
• mctp://<host>:<port>/devices - 獲取所有連接設備列表

項目結構

.
├── package.json          # 項目依賴和腳本配置
├── src                  # 源代碼目錄
│   ├── index.js         # 主程序入口文件
│   └── screenshot.js    # 截圖處理邏輯
└── README.md            # 項目文檔

📄 許可證

本項目採用MIT許可證。

貢獻

歡迎貢獻！請隨時提交Pull Request。