MCP Server Adb

ADB MCP服务器

用于Android调试桥（ADB）的MCP服务器，使Claude能够与Android设备交互。

工具

1. get-devices

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

1. list-packages

- 列出设备上已安装的软件包 - 可选输入： - showPath （布尔值，默认值：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） - 返回：基于指定筛选器的包列表

1. input-text

- 向设备输入文本 - 所需输入： - text （string）：要输入的文本 - 返回：文本输入确认

1. install-apk

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

1. uninstall-apk

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

1. clear-app-data

- 清除应用程序数据 - 所需输入： - packageName （string）：要清除数据的包名称 - 返回：运算结果

1. pull

- 从设备中提取文件 - 所需输入： - remotePath （string）：设备上文件的路径 - 可选输入： - localPath （string）：本地目标路径 - 返回：文件传输结果

1. push

- 将文件推送到设备 - 所需输入： - localPath （string）：本地文件的路径 - remotePath （string）：设备上的目标路径 - 返回：文件传输结果

1. screencap

- 截图 - 所需输入： - remotePath （string）：设备上保存屏幕截图的路径（例如/sdcard/screscent.png） - 可选输入： - usePng （布尔值，默认值：true）：另存为PNG（-p） - 返回：截图捕获结果

1. rm

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

1. reset-permissions

- 重置应用程序的所有权限 - 所需输入： - packageName （string）：目标包名称 - 返回：权限重置结果

1. grant-permission

- 授予特定权限 - 所需输入： - packageName （string）：目标包名称 - permission （string）：授予权限 - 返回：权限授予结果

1. revoke-permission

- 撤销特定权限 - 所需输入： - packageName （string）：目标包名称 - permission （string）：撤销权限 - 返回：权限撤销结果

1. start-activity

- 使用am Start启动活动 - 可选输入： - component （string）：组件名称 - action （string）：意图动作 - data （string）：意图数据URI - mimeType （string）：MIME类型 - category （string\[\]）：意图类别 - extras （array）：意图附加 - flags （string\[\]）：意图标志 - waitForLaunch （布尔值，默认值：false）：等待启动（-W） - debuggable （布尔值，默认值：false）：调试模式（-D） - stopApp （布尔值，默认值：false）：强制停止应用程序（-S） - 返回：活动开始结果

1. kill-server

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

1. start-server

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

1. help

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

所有工具都支持这些设备选择参数：

• deviceId （字符串，可选）：按ID定位特定设备
• useUsb （布尔值，默认值：false）：目标USB设备（-d）
• useEmulator （布尔值，默认值：false）：目标模拟器（-e）

设置

1. 安装ADB：

- 下载Android SDK平台工具 - 将ADB添加到系统PATH - 通过以下方式验证安装 adb version

1. 启用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许可证获得许可-请参阅 许可证 文件以获取详细信息。