这是一个用于 Android Debug Bridge (ADB) 的 MCP 服务器，使 Claude 能够与 Android 设备进行交互。
-
get-devices- 列出已连接的 Android 设备
- 可选参数：
showDetails(布尔值, 默认: true): 显示设备详细信息 (-l)
-
list-packages- 列出设备上已安装的软件包
- 可选参数：
showPath(布尔值, 默认: false): 显示 APK 文件路径 (-f)showDisabled(布尔值, 默认: false): 仅显示已禁用的包 (-d)showEnabled(布尔值, 默认: false): 仅显示已启用的包 (-e)showSystem(布尔值, 默认: false): 仅显示系统包 (-s)showThirdParty(布尔值, 默认: false): 仅显示第三方包 (-3)showInstaller(布尔值, 默认: false): 显示包安装程序 (-i)includeUninstalled(布尔值, 默认: false): 包含已卸载的包 (-u)
-
input-text- 向设备输入文本
- 必需参数：
text(字符串): 要输入的文本
-
install-apk- 安装 APK 文件到设备
- 必需参数：
apkPath(字符串): APK 文件路径
- 可选参数：
allowReinstall(布尔值, 默认: true): 允许重新安装 (-r)allowTestPackages(布尔值, 默认: true): 允许测试包 (-t)allowDowngrade(布尔值, 默认: true): 允许降级 (-d)grantPermissions(布尔值, 默认: false): 授予所有权限 (-g)
-
uninstall-apk- 卸载应用程序
- 必需参数：
packageName(字符串): 要卸载的包名
- 可选参数：
keepData(布尔值, 默认: false): 保留应用数据和缓存 (-k)
-
clear-app-data- 清除应用程序数据
- 必需参数：
packageName(字符串): 要清除数据的包名
-
pull- 从设备拉取文件
- 必需参数：
remotePath(字符串): 设备上的文件路径
- 可选参数：
localPath(字符串): 本地目标路径
-
push- 推送文件到设备
- 必需参数：
localPath(字符串): 本地文件路径remotePath(字符串): 设备上的目标路径
-
screencap- 截取屏幕截图
- 必需参数：
remotePath(字符串): 在设备上保存截图的路径（例如：/sdcard/screenshot.png）
- 可选参数：
usePng(布尔值, 默认: true): 保存为 PNG 格式 (-p)
-
rm- 从 Android 设备删除文件
- 必需参数：
path(字符串): 要删除的设备上的文件路径
- 可选参数：
force(布尔值, 默认: false): 强制删除 (-f)recursive(布尔值, 默认: false): 递归删除 (-r)
-
reset-permissions- 重置应用的所有权限
- 必需参数：
packageName(字符串): 目标包名
-
grant-permission- 授予特定权限
- 必需参数：
packageName(字符串): 目标包名permission(字符串): 要授予的权限
-
安装 ADB:
- 下载 Android SDK Platform Tools
- 将 ADB 添加到系统环境变量
- 使用
adb version验证安装
-
启用 USB 调试:
- 在 Android 设备上，进入设置 > 关于手机
- 点击版本号 7 次以启用开发者选项
- 在开发者选项中启用 USB 调试
# 克隆仓库
git clone [repository-url]
cd mcp-server-adb
# 安装依赖
npm install
# 构建项目
npm run build在你的 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 可执行文件路径。
-
首先确保已经安装了 Node.js 和 ADB
-
克隆并构建项目：
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 -
在 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 安装在其他位置，请相应修改- 确保所有路径都使用绝对路径
-
重启 Windsurf 使配置生效
本项目采用 MIT 许可证 - 详见