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"]
    }
  }
}

or

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

Cursor

Add to your MCP configuration in Cursor settings:

1. Open Cursor Settings
2. Navigate to Extensions → MCP
3. 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