Enhanced ADB MCP Server for Flutter/Android Development

A comprehensive MCP server for controlling Android devices via ADB, specifically designed for Flutter development, UI testing, and visual QA workflows.

Quick Start

# Install from PyPI
pip install r-adb-mcp-server

# Or run directly with uvx (no installation needed)
uvx r-adb-mcp-server

Note: Both the package name and command are r-adb-mcp-server.

Then add to your MCP client configuration (Claude Desktop, Cursor, etc.) - see Configuration section below.

Features

📱 Device Management

• List connected devices with details

• Get comprehensive device info (model, Android version, battery, etc.)

• Screen specifications with DP calculations

📸 Visual Capture

• Screenshots (base64 or file)

• Screen recording with start/stop control

• Capture with metadata for Figma comparison

🔍 UI Inspection

• Full UI hierarchy dump (XML)

• Find elements by text or resource ID

• Get all clickable elements with coordinates

• Extract all visible text for verification

🎯 Input & Interaction

• Tap, double-tap, long-press

• Swipe and scroll (up/down/to-text)

• Text input and clear

• Key events (HOME, BACK, ENTER, etc.)

• Tap elements by text or ID

📦 App Management

• Launch/stop/clear apps

• Install/uninstall APKs

• List packages with filtering

• Get current activity

• App info (version, install date, etc.)

🐛 Debugging & Logs

• Logcat with filtering (tag, level, package)

• Flutter-specific logs

• Crash logs extraction

• ANR traces

⚡ Performance Profiling

• Memory usage per app

• CPU monitoring

• GPU rendering info

• Frame stats for jank detection

• Battery statistics

🌐 Network Control

• Network info (WiFi status, IP)

• Toggle WiFi/Airplane mode

• Set/clear HTTP proxy

⚙️ Developer Options

• Animation scale (speed up tests)

• Show taps (for recordings)

• Show layout bounds

• Screen rotation control

• Change resolution/density

♿ Accessibility Testing

• Font scale adjustment

• TalkBack toggle

• High contrast mode

• Color inversion

📍 Emulator Features

• GPS location spoofing

• Simulate SMS/calls

Prerequisites

1. ADB installed and in your PATH

   adb version

2. Android device/emulator connected with USB debugging enabled

   adb devices

3. Python 3.10+ and optionally uv for running with uvx

   To install uv (optional, for uvx command):

   # macOS/Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Or with Homebrew (macOS)
   brew install uv
   
   # Or with pip
   pip install uv

Installation

From PyPI (Recommended)

# Install globally with pip
pip install r-adb-mcp-server

# Or use with uvx (no installation needed)
uvx r-adb-mcp-server

From Source

cd adb-mcp-server

# Using uv (recommended)
uv sync

# Or using pip
pip install -e .

Configuration

Claude Desktop

Using installed package (recommended):

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "adb": {
      "command": "uvx",
      "args": ["r-adb-mcp-server"]
    }
  }
}

Or if installed with pip:

{
  "mcpServers": {
    "adb": {
      "command": "r-adb-mcp-server"
    }
  }
}

Using from source:

{
  "mcpServers": {
    "adb": {
      "command": "uv",
      "args": ["--directory", "/path/to/adb-mcp-server", "run", "python", "src/adb_mcp_server/server.py"]
    }
  }
}

Cursor IDE

Add to .cursor/mcp.json:

Using installed package (recommended):

{
  "mcpServers": {
    "adb": {
      "command": "uvx",
      "args": ["r-adb-mcp-server"]
    }
  }
}

Using from source:

{
  "mcpServers": {
    "adb": {
      "command": "uv",
      "args": ["--directory", "/path/to/adb-mcp-server", "run", "python", "src/adb_mcp_server/server.py"]
    }
  }
}

Claude Code

Using installed package (recommended):

claude mcp add adb -- uvx r-adb-mcp-server

Using from source:

claude mcp add adb -- uv --directory /path/to/adb-mcp-server run python src/adb_mcp_server/server.py

GitHub Copilot

Using installed package (recommended):

Add to your VS Code settings (.vscode/settings.json or User Settings):

{
  "github.copilot.chat.mcp.servers": {
    "adb": {
      "command": "uvx",
      "args": ["r-adb-mcp-server"]
    }
  }
}

Or if installed with pip:

{
  "github.copilot.chat.mcp.servers": {
    "adb": {
      "command": "r-adb-mcp-server"
    }
  }
}

Using from source:

{
  "github.copilot.chat.mcp.servers": {
    "adb": {
      "command": "uv",
      "args": ["--directory", "/path/to/adb-mcp-server", "run", "python", "src/adb_mcp_server/server.py"]
    }
  }
}

Note: Make sure you have GitHub Copilot Chat extension installed and MCP support enabled in VS Code.

Available Tools (60+)

Device Management

Visual Capture

UI Inspection

Input & Interaction

App Management

Debugging & Logs

Performance

Network

Developer Options

Accessibility

Files & Shell

Emulator Only

Example Prompts

Basic Usage

• "Take a screenshot of my phone"

• "What's the current screen resolution and density?"

• "List all installed apps containing 'flutter'"

• "What's currently on screen? Get all the text"

UI Testing

• "Find the login button and tap it"

• "Scroll down until you find 'Settings'"

• "Get all clickable elements and their positions"

• "Type 'test@email.com' into the current field"

Debugging

• "Show me the last 50 Flutter logs"

• "Are there any crash logs for my app?"

• "What's the memory usage of com.myapp?"

Visual QA

• "Capture this screen for comparison with Figma"

• "Take a screenshot and tell me about the UI structure"

• "Set the font scale to 1.3 and take a screenshot for accessibility testing"

Performance Testing

• "Set animation scale to 0 and run through the app"

• "Get frame stats for my app - is there any jank?"

• "What's the GPU rendering performance?"

Device Simulation

• "Change the screen to 1080x1920 to simulate a smaller phone"

• "Rotate to landscape mode"

• "Set location to San Francisco (37.7749, -122.4194)"

Extending

Add new tools easily:

@mcp.tool()
def my_custom_tool(param: str, device_serial: str | None = None) -> str:
    """Description shown to AI"""
    return run_adb(["shell", "your-command", param], device_serial)

Tips for Flutter Development

1. Speed up tests: Use set_animation_scale(0) to disable animations

2. Visual QA: Use capture_screen_for_comparison() with Figma MCP

3. Debug logs: get_flutter_logs() filters Flutter-specific output

4. Hot reload: Keep flutter run terminal open, use device for interaction

5. Responsive testing: Use change_screen_size() and change_density()

License

MIT