MCP Server Adb

🚀 mcp-server-adb 服務端

mcp-server-adb 是一個基於 TypeScript 的 MCP 服務器，專為 Android 調試橋接（ADB）控制而設計。它為 AI 助手提供了與安卓設備交互的能力，具備設備發現、控制、應用管理以及分析診斷等功能，極大地提升了安卓設備調試與管理的效率。

🚀 快速開始

要使用 mcp-server-adb 服務端，你需要滿足以下先決條件：

• Node.js 16 或更高版本。
• Android 調試橋接（ADB）已安裝並添加到 PATH 環境變量中。
• 啟用 USB 調試的安卓設備，或支持網絡 ADB 的設備。

✨ 主要特性

資源

• 列出連接的設備：device://list
• 獲取設備信息：device://{serial}/info
• 查看已安裝包：device://{serial}/packages
• 截取屏幕截圖：device://{serial}/screenshot

工具

1. 設備控制工具
   • connect_device：通過網絡連接到設備。
   • disconnect_device：斷開網絡連接的設備。
2. 應用管理工具
   • install_app：安裝 APK 文件。
   • uninstall_app：卸載已安裝的應用程序。
   • start_app：啟動應用程序。
   • stop_app：強制停止應用程序。
3. 設備輸入工具
   • tap：模擬屏幕點擊。
   • swipe：模擬屏幕滑動。
   • input_text：輸入文本。
   • press_key：模擬按鍵按壓。
   • take_screenshot：截取屏幕。

提示

• analyze_device：分析設備狀態和規格。
• analyze_app_list：分析已安裝的應用程序。
• analyze_screen：分析當前屏幕內容。

📦 安裝指南

開發環境安裝

安裝依賴：

npm install

構建服務器：

npm run build

帶有自動重建功能的開發環境：

npm run watch

在 Claude Desktop 中使用

要在 Claude Desktop 中使用，請添加以下服務器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-adb": {
      "command": "/path/to/mcp-server-adb/build/index.js"
    }
  }
}

調試

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能具有挑戰性。我們推薦使用 MCP 檢查器，該檢查器作為包腳本提供：

npm run inspector

檢查器將提供一個 URL，用於在瀏覽器中訪問調試工具。

設備設置

1. 在安卓設備上啟用 USB 調試：
   • 進入設置 > 關於手機。
   • 點擊“構建編號”七次以啟用開發者選項。
   • 進入設置 > 開發者選項。
   • 啟用“USB 調試”。
2. 對於網絡調試：
   • 先通過 USB 連接設備。
   • 在開發者選項中啟用“無線調試”。
   • 使用 connect_device 工具與設備的 IP 地址一起使用。