ADB Friend

ADB Friend

ADB Friend 是一款小巧的 CLI 工具，可帮助你通过 ADB 管理 Android 设备。 它的大多数功能都是为开发者设计的，但也适用于所有人。

功能

• 将文件从电脑同步到手机
  • 专为测试数据设计，会跳过设备上已存在的文件
• 配置设备以进行测试
  • 禁用动画、启用触摸显示等
• 按模式卸载应用
• Packages 命令
  • 对所有匹配 glob 的软件包应用沉浸式标志、强制停止应用、清除应用数据和缓存
• 其他工具
  • adb-speed（帮助识别性能不佳的数据线）
• Model Context Protocol MCP 服务

安装

可以使用 Homebrew 进行安装。首先，你需要添加自定义 tap：

brew tap mikepenz/tap

接下来，安装 AdbFriend CLI：

brew install mikepenz/tap/adbfriend

你也可以从发布页面下载预构建二进制文件。

用法

ADB Friend 是一款可在终端中使用的命令行工具。

# Get started with the `--help` command, to get information and an overview on the various features offered.
adbfriend --help

MCP 服务

ADB Friend（从版本 1.4.0 起）还提供 Model Context Protocol（MCP）服务，可配置到常见的 AI 工具中，例如 Claude Desktop、GitHub Copilot、RayCast 等。

配置

配置文件的位置和具体内容取决于所使用的工具。以下示例适用于 Claude Desktop。

{
  "mcpServers": {
    "adb-friend": {
      "command": "/opt/homebrew/bin/adbfriend",
      "args": [
        "mcp",
        "server"
      ],
      "env": {
        "ANDROID_HOME": "/Users/mikepenz/Development/android/sdk"
      }
    }
  }
}

重要

如果未提供 ANDROID_HOME，则必须在你的机器上手动启动 adb-server。 否则会引发连接异常。

调试服务

启动服务后，你可以使用 npx @modelcontextprotocol/inspector 进行调试。

# Install and run inspector in your terminal
npx @modelcontextprotocol/inspector

然后启动网站（网址会显示在终端中）。 使用 IntelliJ 或实际命令启动 mcp server。

# Default port is `3001`
adbfriend mcp server --sse true

支持的工具

工具名称	描述
check-adb-speed	检查指定序列号的 Android 设备的 USB 连接速度。
clear-installed-package	清除 Android 设备上指定软件包名称的软件包数据。
set-immersive-full-for-package	为 Android 设备上指定的软件包名称设置 immersive-full 标志。
force-stop-process	强制停止 Android 设备上指定的软件包名称对应的进程。
uninstall-package	卸载 Android 设备上指定的软件包名称。
get-connected-devices	获取所有已连接 Android 设备的信息，包括序列号、型号和状态。
get-installed-packages	获取 Android 设备上所有已安装软件包的信息。支持仅筛选第三方应用。
list_allowed_directories	列出文件系统工具允许访问的目录。
list-files	列出 Android 设备上的文件和目录。支持使用 recursive 选项递归列出。
read-file	读取 Android 设备上文件的内容。
read_multiple_files	一次读取多个 Android 设备上的文件内容（减少大模型调用次数）。
write-file	将内容写入 Android 设备上的文件。
create-directory	在 Android 设备上创建目录。
delete	删除文件或目录。
search-files	在允许的目录中搜索匹配不区分大小写的 glob 模式的文件。
move_file	将 Android 设备上的文件从源路径移动到目标路径。
copy-file-to-host	将二进制文件从 Android 设备复制到主机系统。
capture-screenshot	截取 Android 设备的屏幕截图并保存到主机系统。
install-apk	从主机系统允许的路径中的文件在 Android 设备上安装 APK。

未来还计划推出更多工具。

示例提示词

uninstall the 'sample' app, but keep its data

force stop the 'sample' app

Do I have a browser installed on the connected emulator?

Organize all files in the Download folder of the connected Android device

 Pull all KotlinConf related files from the Android device to the host

发布

项目使用 shadow 将工具打包为 fat-jar，并进行最低限度的缩减。

./gradlew adbfriend-cli:shadowDistZip

其他

AboutLibraries

为 adbfriend 生成 aboutlibraries.json

./gradlew adbfriend:exportLibraryDefinitions

为 adbfriend-cli 生成 aboutlibraries.json

./gradlew adbfriend-cli:exportLibraryDefinitions

示例提示词截图

Claude Desktop

Visual Code

致谢

本项目使用了 Malinskiy 开发的出色 adam 库 与 adb 交互。 CLI 使用了 ajalt 开发的出色 clikt 库进行配置。

许可证

Copyright 2025 Mike Penz

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.