ADB MCP 服务器

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

技术文章

- 从 0 到 1 开发一个 Android MCP 服务：理解 MCP 协议与 ADB 集成

工具列表

1. get-devices

- 列出已连接的 Android 设备
- 可选参数：
- showDetails (布尔值, 默认: true): 显示设备详细信息 (-l)

2. list-packages

- 列出设备上已安装的软件包
- 可选参数：
- showPath (布尔值, 默认: false): 显示 APK 文件路径 (-f)
- showDisabled (布尔值, 默认: false): 仅显示已禁用的包 (-d)
- showEnabled (布尔值, 默认: false): 仅显示已启用的包 (-e)
- showSystem (布尔值, 默认: false): 仅显示系统包 (-s)
- showThirdParty (布尔值, 默认: false): 仅显示第三方包 (-3)
- showInstaller (布尔值, 默认: false): 显示包安装程序 (-i)
- includeUninstalled (布尔值, 默认: false): 包含已卸载的包 (-u)

3. input-text

- 向设备输入文本
- 必需参数：
- text (字符串): 要输入的文本

4. install-apk

- 安装 APK 文件到设备
- 必需参数：
- apkPath (字符串): APK 文件路径
- 可选参数：
- allowReinstall (布尔值, 默认: true): 允许重新安装 (-r)
- allowTestPackages (布尔值, 默认: true): 允许测试包 (-t)
- allowDowngrade (布尔值, 默认: true): 允许降级 (-d)
- grantPermissions (布尔值, 默认: false): 授予所有权限 (-g)

5. uninstall-apk

- 卸载应用程序
- 必需参数：
- packageName (字符串): 要卸载的包名
- 可选参数：
- keepData (布尔值, 默认: false): 保留应用数据和缓存 (-k)

6. clear-app-data

- 清除应用程序数据
- 必需参数：
- packageName (字符串): 要清除数据的包名

7. pull

- 从设备拉取文件
- 必需参数：
- remotePath (字符串): 设备上的文件路径
- 可选参数：
- localPath (字符串): 本地目标路径

8. push

- 推送文件到设备
- 必需参数：
- localPath (字符串): 本地文件路径
- remotePath (字符串): 设备上的目标路径

9. screencap

- 截取屏幕截图
- 必需参数：
- remotePath (字符串): 在设备上保存截图的路径（例如：/sdcard/screenshot.png）
- 可选参数：
- usePng (布尔值, 默认: true): 保存为 PNG 格式 (-p)

10. rm

- 从 Android 设备删除文件
- 必需参数：
- path (字符串): 要删除的设备上的文件路径
- 可选参数：
- force (布尔值, 默认: false): 强制删除 (-f)
- recursive (布尔值, 默认: false): 递归删除 (-r)

11. reset-permissions

- 重置应用的所有权限
- 必需参数：
- packageName (字符串): 目标包名

12. grant-permission
- 授予特定权限
- 必需参数：
- packageName (字符串): 目标包名
- permission (字符串): 要授予的权限

设置说明

1. 安装 ADB:

- 下载 Android SDK Platform Tools
- 将 ADB 添加到系统环境变量
- 使用 adb version 验证安装

2. 启用 USB 调试:
- 在 Android 设备上，进入设置 > 关于手机
- 点击版本号 7 次以启用开发者选项
- 在开发者选项中启用 USB 调试

安装服务器

```shell