Androidmcpserver

🚀 ADB MCP 服務器

這是一個用於 Android 調試橋接 (ADB) 的 MCP 服務器，藉助它，Claude 能夠與 Android 設備進行交互。

📚 技術文章

• 從 0 到 1 開發一個 Android MCP 服務：理解 MCP 協議與 ADB 集成

✨ 主要特性

該服務器提供了一系列實用工具，可對 Android 設備進行多種操作：

1. get-devices
   • 功能：列出已連接的 Android 設備。
   • 參數：無。
   • 示例輸出：

List of devices attached
0a00000000000000	設備名稱	model	number

2. install-apk
   • 功能：在設備上安裝 APK 文件。
   • 參數：<apk-path>。
   • 示例：

install-apk /path/to/app.apk

3. uninstall-apk
   • 功能：從設備上卸載應用程序。
   • 參數：<package-name>。
   • 示例：

uninstall-apk com.example.app

4. start-activity
   • 功能：啟動指定的 Activity。
   • 參數：<package-name>/<action> [--ez <name> <value>]。
   • 示例：

start-activity com.example/.MainActivity --ez test 123

5. input-text
   • 功能：在設備上輸入文本。
   • 參數：<text>。
   • 示例：

input-text Hello, World!

6. click
   • 功能：模擬在設備上的點擊操作。
   • 參數：<x> <y>。
   • 示例：

click 500 1200

7. screenshot
   • 功能：截取設備屏幕。
   • 參數：無。
   • 示例：

screenshot /path/to/screenshot.png

8. logcat
   • 功能：獲取設備的日誌信息。
   • 參數：[--pid <PID>] [--time]。
   • 示例：

logcat --pid 1234

📦 安裝指南

安裝服務器步驟

# 克隆倉庫
git clone [repository-url]
cd mcp-server-adb

# 安裝依賴
npm install

# 構建項目
npm run build

在 Claude Desktop 中配置

編輯 claude_desktop_config.json 文件，添加以下內容：

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

⚠️ 重要提示

請將 /path/to/adb 替換為你實際的 ADB 可執行文件路徑。

在 Windsurf 中配置

1. 確保已安裝 Node.js 和 ADB。
2. 克隆並構建項目：

git clone https://github.com/jiantao88/android-mcp-server.git
cd android-mcp-server
npm install
npm run build

3. 在 Windsurf 的設置中添加 MCP 配置：

{
  "mcpServers": {
    "adb": {
      "command": "node",
      "args": [
        "/path/to/android-mcp-server/build/index.js",
        "/usr/local/bin/adb"
      ]
    }
  }
}

⚠️ 重要提示

• 請將所有路徑替換為你的實際路徑。
• /usr/local/bin/adb 是 ADB 的默認安裝位置，請根據實際情況調整。

4. 重啟 Windsurf 以應用配置。

📄 許可證

本項目採用 MIT 許可證 - 詳見 LICENSE 文件。