Android Adb MCP Server

🚀 Android ADB MCP 服務器

Android ADB MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它讓 AI 助手能夠藉助 Android 調試橋接（ADB）與 Android 設備進行交互。該服務器將 AI 功能與 Android 設備管理相連接，實現了 Android 開發和測試操作的無縫自動化。

🚀 快速開始

⚙️ 快速設置

將服務器添加到您的 MCP 配置文件中：

{
  "mcpServers": {
    "android-adb": {
      "command": "npx",
      "args": ["-y", "@landicefu/android-adb-mcp-server"],
      "env": {},
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

配置位置

• Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）
• Cline/Roo Code：~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json（macOS）
• 對於 Windows/Linux，請檢查相應應用程序支持目錄

配置完成後，重啟您的 AI 助手以加載新的服務器配置。

📦 安裝指南

📋 先決條件

• ADB (Android Debug Bridge) 必須已安裝並添加到系統 PATH
  • 在 Windows/Linux/Ubuntu 上安裝 ADB
• 剪貼板工具：
  • Windows：clip.exe
  • macOS：pbcopy
  • Linux：xclip 或 wl-copy
• Node.js (16.0+)

📦 其他安裝方式

方法一：npm 安裝

npm install -g @landicefu/android-adb-mcp-server

方法二：手動安裝從源碼

1. 克隆倉庫：

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

2. 安裝依賴並構建：

npm install
npm run build

3. 配置直接路徑：

{
  "mcpServers": {
    "android-adb": {
      "command": "node",
      "args": ["/path/to/android-adb-mcp-server/build/index.js"],
      "env": {},
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

✨ 主要特性

📸 功能

✨ 可用工具

🛠️ 設備管理

• 自動選擇設備：如果只有一個設備連接，直接使用該設備
• 指定設備ID：通過參數 -d <設備ID> 指定特定設備
• 多設備支持：支持同時操作多個設備

📄 截圖路徑解析

• 絕對路徑：/path/to/screen.png
• 相對路徑：./screen.png
• 以波浪線開頭的路徑：~/screen.png

🔧 技術細節

🔧 故障排除

常見問題

1. 設備未連接
   • 確保設備已通過 USB 連接
   • 檢查設備是否允許調試
2. ADB 未安裝
   • 參考先決條件安裝 ADB
3. 權限問題
   • 使用管理員權限運行命令
4. 日誌無輸出
   • 確保設備已連接且有日誌輸出

解決方法

1. 檢查設備是否正確連接：

adb devices

2. 啟動 ADB 服務：

adb start-server

📄 許可證

本項目遵循 ISC 許可證，詳情請查看 LICENSE 文件。

🤝 貢獻指南

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

1. 叉倉庫：

git fork

2. 創建功能分支：

git checkout -b feature/amazing-feature

3. 提交更改：

git commit -m 'Add some amazing feature'

4. 推送到分支：

git push origin feature/amazing-feature

5. 提交 Pull Request