ADB MCP Server

ADB MCP 服务

适用于 Android Debug Bridge（ADB）的 MCP 服务，让 Claude 能够与 Android 设备交互。

工具

1. get-devices

   • 列出已连接的 Android 设备
   • 可选输入：
     • showDetails（boolean，默认值：true）：显示设备详细信息（-l）
   • 返回：包含详细信息的已连接设备列表

2. list-packages

   • 列出设备上已安装的软件包
   • 可选输入：
     • showPath（boolean，默认值：false）：显示 APK 文件路径（-f）
     • showDisabled（boolean，默认值：false）：仅显示已停用的软件包（-d）
     • showEnabled（boolean，默认值：false）：仅显示已启用的软件包（-e）
     • showSystem（boolean，默认值：false）：仅显示系统软件包（-s）
     • showThirdParty（boolean，默认值：false）：仅显示第三方软件包（-3）
     • showInstaller（boolean，默认值：false）：显示软件包安装程序（-i）
     • includeUninstalled（boolean，默认值：false）：包含未安装的软件包（-u）
   • 返回：根据指定筛选条件生成的软件包列表

3. input-text

   • 向设备输入文本
   • 必填输入：
     • text（string）：要输入的文本
   • 返回：文本输入确认

4. install-apk

   • 在设备上安装 APK 文件
   • 必填输入：
     • apkPath（string）：APK 文件的路径
   • 可选输入：
     • allowReinstall（boolean，默认值：true）：允许重新安装（-r）
     • allowTestPackages（boolean，默认值：true）：允许测试软件包（-t）
     • allowDowngrade（boolean，默认值：true）：允许降级（-d）
     • grantPermissions（boolean，默认值：false）：授予所有权限（-g）
   • 返回：安装结果

5. uninstall-apk

   • 卸载应用
   • 必填输入：
     • packageName（string）：要卸载的软件包名称
   • 可选输入：
     • keepData（boolean，默认值：false）：保留应用数据和缓存（-k）
   • 返回：卸载结果

6. clear-app-data

   • 清除应用数据
   • 必填输入：
     • packageName（string）：要清除数据的软件包名称
   • 返回：操作结果

7. pull

   • 从设备拉取文件
   • 必填输入：
     • remotePath（string）：设备上文件的路径
   • 可选输入：
     • localPath（string）：本地目标路径
   • 返回：文件传输结果

8. push

   • 向设备推送文件
   • 必填输入：
     • localPath（string）：本地文件的路径
     • remotePath（string）：设备上的目标路径
   • 返回：文件传输结果

9. screencap

   • 截取屏幕截图
   • 必填输入：
     • remotePath（string）：设备上用于保存截图的路径（例如，/sdcard/screenshot.png）
   • 可选输入：
     • usePng（boolean，默认值：true）：保存为 PNG（-p）
   • 返回：截图结果

10. rm

    • 删除 Android 设备上的文件
    • 必填输入：
      • path（string）：设备上要删除的文件路径
    • 可选输入：
      • force（boolean，默认值：false）：强制删除（-f）
      • recursive（boolean，默认值：false）：递归删除（-r）
    • 返回：文件删除结果

11. reset-permissions

    • 重置应用的所有权限
    • 必填输入：
      • packageName（string）：目标软件包名称
    • 返回：权限重置结果

12. grant-permission

    • 授予特定权限
    • 必填输入：
      • packageName（string）：目标软件包名称
      • permission（string）：要授予的权限
    • 返回：权限授予结果

13. revoke-permission

    • 撤销特定权限
    • 必填输入：
      • packageName（string）：目标软件包名称
      • permission（string）：要撤销的权限
    • 返回：权限撤销结果

14. start-activity

    • 使用 am start 启动 Activity
    • 可选输入：
      • component (string)：组件名称
      • action (string)：Intent 操作
      • data (string)：Intent 数据 URI
      • mimeType (string)：MIME 类型
      • category (string[])：Intent 类别
      • extras (array)：Intent 附加数据
      • flags (string[])：Intent 标志
      • waitForLaunch (boolean, default: false)：等待启动（-W）
      • debuggable (boolean, default: false)：调试模式（-D）
      • stopApp (boolean, default: false)：强制停止应用（-S）
    • 返回：Activity 启动结果

15. kill-server

    • 终止 ADB 服务进程
    • 无需输入
    • 返回：成功消息或错误

16. start-server

    • 启动 ADB 服务进程
    • 无需输入
    • 返回：成功消息或错误

17. help

    • 显示 ADB 帮助信息
    • 无需输入
    • 返回：ADB 帮助文本

所有工具均支持以下设备选择参数：

• deviceId (string, optional)：按 ID 指定目标设备
• useUsb (boolean, default: false)：指定 USB 设备（-d）
• useEmulator (boolean, default: false)：指定模拟器（-e）

设置

1. 安装 ADB：

   • 下载 Android SDK Platform Tools
   • 将 ADB 添加到系统 PATH
   • 使用 adb version 验证安装

2. 启用 USB 调试：

   • 在 Android 设备上，前往“设置”>“关于手机”
   • 点按“版本号”7 次以启用“开发者选项”
   • 在“开发者选项”中启用 USB 调试

安装服务

# Clone the repository
git clone [repository-url]
cd mcp-server-adb

# Install dependencies
npm install

# Build the project
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 可执行文件的实际路径。

许可证

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。