ADB MCP 服务器

基本能力

产品定位

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

核心功能

1. 设备管理：列出已连接的 Android 设备，显示设备详细信息。
2. 软件包管理：列出设备上已安装的软件包，支持多种筛选条件。
3. 文本输入：向设备输入文本。
4. APK 管理：安装和卸载 APK 文件，支持多种安装选项。
5. 文件操作：从设备拉取文件、推送文件到设备、删除设备上的文件。
6. 屏幕截图：截取设备屏幕并保存为图片。
7. 权限管理：重置应用权限或授予特定权限。

适用场景

1. 开发调试：在开发过程中快速管理和操作 Android 设备。
2. 自动化测试：通过脚本自动化执行设备操作。
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：从 Android 设备删除文件。
11. reset-permissions：重置应用的所有权限。
12. grant-permission：授予特定权限。

常见问题解答

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

使用教程

使用依赖

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

安装教程

# 克隆仓库
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

或者直接使用已经克隆的项目：

cd /path/to/android-mcp-server
npm install
npm run build

1. 在 Windsurf 的设置中添加 MCP 配置：

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

注意： - 将路径中的路径替换为你的实际路径 - /usr/local/bin/adb 是 ADB 的默认安装路径，如果你的 ADB 安装在其他位置，请相应修改 - 确保所有路径都使用绝对路径 4. 重启 Windsurf 使配置生效

调试方式

1. 确保 ADB 已正确安装并添加到环境变量。
2. 确保 Android 设备已启用 USB 调试并连接到计算机。
3. 使用 adb devices 命令验证设备是否被识别。
4. 运行 MCP 服务器并检查日志输出是否有错误。

许可证

该项目遵循 MIT 开源许可条款。