Android Debug Bridge MCP

MCP plugin to control Android devices via ADB for automation, testing, and agent integration.

Features

This MCP server provides tools to:

Test Management: Create test folders for organizing automation tests
App Control: List installed apps by name pattern and open apps by package name
Screen Capture: Take screenshots and save them to organized test folders
UI Analysis: Capture UI hierarchy dumps for element inspection
Input Simulation:
- Send key events (BACK, HOME, ENTER, DELETE)
- Tap at specific coordinates
- Input text into active fields
- Scroll in any direction (up, down, left, right)

Installation

Install the package globally via npm:

npm install -g android-debug-bridge-mcp

Setup for Different AI Clients

Claude Code (CLI)

Add to your MCP configuration in ~/.claude/mcp.json:

{
  "mcpServers": {
    "android-debug-bridge": {
      "command": "npx",
      "args": ["android-debug-bridge-mcp"]
    }
  }
}

claude mcp add --scope project android-debug-bridge-mcp -- npx android-debug-bridge-mcp

Cursor

Add to your MCP configuration in Cursor settings:

Open Cursor Settings
Navigate to Extensions → MCP
Add a new server with:
- Name: android-debug-bridge
- Command: npx
- Args: ["android-debug-bridge-mcp"]

Claude Desktop

Add to your MCP configuration file:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "android-debug-bridge": {
      "command": "npx",
      "args": ["android-debug-bridge-mcp"]
    }
  }
}

Prerequisites

Android Debug Bridge (ADB) must be installed and available in your PATH
Android device with USB debugging enabled, or Android emulator running
Device must be connected and authorized for debugging

Usage

Once configured, you can interact with Android devices through your AI client by asking questions like:

"Create a test folder called 'login_test'"
"List all apps with 'chrome' in the name"
"Open the app com.android.chrome"
"Take a screenshot and save it as step '001_homepage'"
"Capture the current UI hierarchy in my app"
...

License

MIT

Android Debug Bridge