ADB Friend

Name: ADB Friend
Author: mikepenz

@mikepenz

代码仓库

关于 ADB Friend

Android ADB CLI tool including integrated MCP Server with common adb actions used during development

#android #kotlin #cli #tools #ai #adb #gradle #mcp #kmp #androiddebugbridge #mcp-server

基本信息

分类

其他

许可证

Apache-2.0

运行时

kotlin

传输方式

stdio

发布者

mikepenz

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "adbfriend": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is ADB Friend?

ADB Friend is a CLI tool that helps manage Android devices via ADB, with features designed for developers. It also provides a Model Context Protocol (MCP) server for integration with AI tools like Claude Desktop, GitHub Copilot, and RayCast.

How to use ADB Friend?

Install via Homebrew (brew install mikepenz/tap/adbfriend) or download prebuilt binaries. Use adbfriend --help for an overview of CLI commands. For the MCP server, configure the tool with a JSON entry specifying the command, arguments, and optional ANDROID_HOME environment variable.

Key features of ADB Friend

Sync files from computer to phone, skipping existing files
Configure device for tests (disable animations, enable touches, etc.)
Uninstall apps by pattern
Apply immersive flag, force-stop, clear app data & cache
Check USB connection speed with adb-speed tool
Provides an MCP server with 18 file and device management tools

Use cases of ADB Friend

Uninstall an app but keep its data
Force-stop a specific app on a connected device
Check if a browser is installed on an emulator
Organize all files in the Download folder of a device
Pull all files related to a specific event from device to host

FAQ from ADB Friend

Does ADB Friend require ANDROID_HOME to be set?

If ANDROID_HOME is not provided in the MCP server configuration, the ADB server must be manually started; otherwise, a connection exception is thrown.

What MCP tools does ADB Friend provide?

It offers tools to check ADB speed, clear package data, set immersive full mode, force‑stop processes, uninstall packages, list connected devices and installed packages, list files, read/write files, create directories, delete, search, move files, copy files to host, capture screenshots, and install APKs.

How can I debug the ADB Friend MCP server?

Use npx @modelcontextprotocol/inspector to start the inspector, then launch the server with adbfriend mcp server --sse true on port 3001.

How do I install ADB Friend?

You can install it via Homebrew with a custom tap: brew tap mikepenz/tap then brew install mikepenz/tap/adbfriend, or download prebuilt binaries from the releases page.