关键词

Android管理ADB工具AI助手集成设备文件操作应用管理

项目简介

ADB Friend 是一个轻量级的命令行工具，旨在简化通过 Android Debug Bridge (ADB) 与 Android 设备交互的过程。它提供了一系列实用的功能，例如文件同步、应用管理、设备配置等，主要面向开发者，但也适用于普通用户。更重要的是，ADB Friend 集成了一个 Model Context Protocol (MCP) 服务器，允许支持 MCP 的 AI 工具（如 Claude Desktop, GitHub Copilot Chat, RayCast）直接调用这些 ADB 功能，极大地增强了 AI 助手在管理 Android 设备方面的能力。

主要功能点

  • 设备文件操作: 允许在计算机和 Android 设备之间同步、列出、读取、写入、移动、创建和删除文件及目录。
  • 应用管理: 支持按模式卸载应用，对应用包设置沉浸模式标志，强制停止应用进程，以及清除应用数据和缓存。
  • 设备信息与配置: 可以获取连接的 Android 设备列表、已安装应用列表，并能快速配置设备以进行测试（如禁用动画）。
  • 其他工具: 包含检查 ADB 连接速度等额外实用功能。
  • AI助手集成: 通过内置的MCP服务器，将上述ADB操作能力暴露给支持MCP协议的AI客户端。

安装步骤

推荐使用 Homebrew 进行安装（适用于 macOS 和 Linux）：

  1. 添加 ADB Friend 的自定义 Tap 源： 
    brew tap mikepenz/tap
  2. 安装 ADB Friend CLI 工具： 
    brew install mikepenz/tap/adbfriend

或者，你可以从项目的发布页面下载预编译的二进制文件。

服务器配置

ADB Friend 的 MCP 服务器需要被支持 MCP 的 AI 客户端（如 Claude Desktop, GitHub Copilot Chat, RayCast等）配置和启动。配置信息通常在AI客户端的应用设置中完成，以下是配置时所需提供的主要信息示例：

  • 服务器名称: 为此MCP服务器实例指定一个名称，例如 'adb-friend'。
  • 启动命令 (command): 指定启动ADB Friend可执行文件的完整路径。例如，如果通过Homebrew安装，路径可能是 '/opt/homebrew/bin/adbfriend' 或其他系统路径。
  • 命令参数 (args): 提供启动MCP服务器所需的参数列表。对于ADB Friend，通常是 '["mcp", "server"]'。
  • 环境变量 (env): 可选地，你可以设置 'ANDROID_HOME' 环境变量指向你的Android SDK路径。如果未设置此环境变量，你需要确保ADB服务已在你的机器上手动启动。

基本使用方法

一旦在你的AI客户端中配置并启动了 ADB Friend MCP 服务器，你就可以在与AI助手的对话中，通过自然语言指令来利用ADB Friend的功能。AI助手会识别你的意图，并使用MCP协议调用ADB Friend服务器提供的相应“工具”来执行操作。例如，你可以对AI助手说：

  • “卸载名字包含 'sample' 的应用。”
  • “强制停止 'com.example.app' 这个应用的进程。”
  • “列出连接的 Android 设备。”
  • “读取设备上 '/sdcard/Documents/test.txt' 文件的内容。”

AI助手将通过MCP服务器与你的Android设备交互，并返回操作结果。直接在终端运行 'adbfriend --help' 可以查看所有命令行功能，但这与通过MCP服务器进行AI交互是不同的使用模式。

信息

分类

桌面与硬件

访问项目