ADB MCP Server

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

技术文章

• 从零开始构建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调试

安装服务器

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

3. 在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以使配置生效

许可证

本项目采用MIT许可证 - 查看详细信息 LICENSE 文件。