ADB MCP Server

基本能力

产品定位

ADB MCP Server 是一个用于 Android Debug Bridge (ADB) 的 MCP 服务器，使 Claude 能够与 Android 设备进行交互。

核心功能

1. 设备管理：列出连接的 Android 设备及其详细信息。
2. 包管理：列出、安装、卸载应用程序，管理应用程序数据。
3. 文件操作：在设备和本地之间传输文件，删除设备上的文件。
4. 权限管理：重置、授予或撤销应用程序权限。
5. 屏幕截图：捕获设备屏幕截图。
6. 活动管理：启动设备上的活动。
7. ADB 服务器管理：启动或终止 ADB 服务器进程。

适用场景

1. Android 开发：在开发过程中管理设备和应用程序。
2. 自动化测试：自动化测试 Android 应用程序。
3. 设备管理：批量管理多个 Android 设备。

工具列表

1. get-devices：列出连接的 Android 设备及其详细信息。
2. list-packages：列出设备上安装的应用程序包。
3. input-text：向设备输入文本。
4. install-apk：安装 APK 文件到设备。
5. uninstall-apk：卸载设备上的应用程序。
6. clear-app-data：清除应用程序数据。
7. pull：从设备拉取文件到本地。
8. push：推送本地文件到设备。
9. screencap：捕获设备屏幕截图。
10. rm：删除设备上的文件。
11. reset-permissions：重置应用程序权限。
12. grant-permission：授予应用程序权限。
13. revoke-permission：撤销应用程序权限。
14. start-activity：启动设备上的活动。
15. kill-server：终止 ADB 服务器进程。
16. start-server：启动 ADB 服务器进程。
17. help：显示 ADB 帮助信息。

常见问题解答

1. 如何安装 ADB？
2. 下载 Android SDK Platform Tools。
3. 将 ADB 添加到系统 PATH 中。
4. 使用 adb version 验证安装。
5. 如何启用 USB 调试？
6. 在 Android 设备上，进入设置 > 关于手机。
7. 点击“版本号”7 次以启用开发者选项。
8. 在开发者选项中启用 USB 调试。

使用教程

使用依赖

1. 安装 ADB： shell # 下载 Android SDK Platform Tools # 将 ADB 添加到系统 PATH 中 # 验证安装 adb version
2. 启用 USB 调试：
3. 在 Android 设备上，进入设置 > 关于手机。
4. 点击“版本号”7 次以启用开发者选项。
5. 在开发者选项中启用 USB 调试。

安装教程

# 克隆仓库
git clone [repository-url]
cd mcp-server-adb

# 安装依赖
npm install

# 构建项目
npm run build

调试方式

1. 确保 ADB 已正确安装并添加到 PATH 中。
2. 确保 Android 设备已启用 USB 调试并连接到计算机。
3. 使用 adb devices 验证设备是否被识别。
4. 运行 MCP 服务器并检查日志以确认正常运行。

与 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 开源许可条款，请参阅 MIT 了解完整条款。