Adb MCP Server

🚀 ADB MCP 服務器

ADB MCP 服務器是一款用於管理 Android 調試橋接 (ADB) 連接，並與 Android 設備進行交互的 Model Context Protocol (MCP) 服務器。它能有效簡化與 Android 設備的交互流程，提升開發和測試效率。

✨ 主要特性

• 設備管理：可列出所有連接的 Android 設備，方便用戶清晰掌握設備連接情況。
• 截圖捕獲：能夠從連接的設備中獲取屏幕截圖，便於記錄設備屏幕狀態。
• UI 元素檢查：可以提取設備屏幕的 UI 層次結構，為 UI 自動化和測試提供有力支持。
• ADB 命令執行：支持在連接的設備上運行任意 ADB 命令，滿足多樣化的操作需求。

📦 安裝指南

先決條件

• 需在系統上安裝 Android 調試橋接 (ADB)，並將其添加到 PATH 環境變量中。
• 安裝 Node.js（版本 14 或更高）。
• 安裝 TypeScript。

安裝步驟

1. 克隆倉庫：

   git clone https://github.com/yourusername/adb-mcp-server.git
   cd adb-mcp-server
   

2. 安裝依賴項：

   npm install
   

3. 構建項目：

   npm run build
   

💻 使用示例

啟動服務器

ADB MCP 服務器作為 Model Context Protocol 服務器通過 stdio 運行：

npm start

若用於開發，帶有文件更改自動重啟的功能，可使用以下命令：

npm run dev

可用工具

服務器暴露了以下 MCP 工具：

基礎用法

1. 獲取連接設備列表

get_devices

此命令會返回所有連接的 Android 設備及其 ID 和連接狀態的列表。

高級用法

2. 捕獲屏幕截圖

capture_screenshot

參數：

• deviceId：要從中捕獲屏幕截圖的設備 ID。
• path：保存截圖的路徑。

截圖將按照以下格式命名：YYYYMMDD_HH_MM_SS.png。

3. 獲取 UI 元素

get_ui_elements

參數：

• deviceId：要提取其 UI 層次結構的設備 ID。

該命令會返回完整的 UI 層次結構，以 XML 格式呈現，適用於 UI 自動化和測試。

4. 執行 ADB 命令

execute_adb_command

參數：

• deviceId：要在其上執行命令的設備 ID。
• command：要執行的 ADB 命令。

此命令允許在指定設備上運行任意 ADB 命令。

📚 詳細文檔

項目結構

adb-mcp-server
├── src
│   ├── index.ts               # 主 MCP 服務器入口點
│   ├── handlers/              # 每個功能的請求處理程序
│   │   ├── deviceList.ts      # 設備列表功能
│   │   ├── screenshot.ts      # 屏幕截圖捕獲功能
│   │   └── uiElements.ts      # UI 層次結構提取功能
│   ├── utils/                 # 工具函數
│   │   ├── adb.ts             # ADB 命令執行工具
│   │   └── screenshot.ts      # 截圖處理工具
│   └── types/                 # TypeScript 類型定義
├── package.json               # 項目依賴和腳本
└── tsconfig.json              # TypeScript 配置

📄 許可證

此項目根據 MIT 許可證發佈，詳細信息見 LICENSE 文件。

貢獻

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