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.