android-debug-mcp-server

lukaj99/android-debug-mcp-server

3.2

If you are the rightful owner of android-debug-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A comprehensive Model Context Protocol (MCP) server for Android USB debugging, providing access to ADB, Fastboot, and Android Platform Tools.

Tools
4
Resources
0
Prompts
0

Android Debug MCP Server

A comprehensive Model Context Protocol (MCP) server for Android USB debugging, providing access to ADB, Fastboot, and Android Platform Tools.

🚀 Quick Start

# Install dependencies
npm install

# Build the server
npm run build

# Run the server (for testing)
npm start

📦 Installation

Prerequisites

Add to Claude Desktop

Edit your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "android-debug": {
      "command": "node",
      "args": [
        "/Users/YOUR_USERNAME/Downloads/android-debug-mcp-server/dist/index.js"
      ],
      "env": {
        "ADB_PATH": "/path/to/platform-tools/adb",
        "FASTBOOT_PATH": "/path/to/platform-tools/fastboot"
      }
    }
  }
}

🛠️ Features

35 Tools Across 5 Categories

Device Management (7 tools)

  • List devices, get info, reboot, wireless ADB, logs, health checks, platform tools setup

App Management (6 tools)

  • List, install, uninstall, backup apps, manage permissions

File Operations (6 tools)

  • Push/pull files, list directories, shell commands, backups

Flashing & Rooting (10 tools)

  • Flash partitions, unlock/lock bootloader, boot images, factory reset, partition management

Screen & Interaction (6 tools - NEW!)

  • Screenshot capture, screen info, input tap/swipe/text, screen recording for visual debugging and UI automation

🔒 Safety Features

  • Expert Mode: Includes destructive operations
  • Confirmation Tokens: Required for dangerous operations
  • Multi-Device Support: Manage multiple devices simultaneously
  • Comprehensive Error Handling: Actionable error messages

📚 Documentation

  • - Detailed system architecture and design
  • - How to contribute to the project
  • - Complete tool documentation

🔧 Troubleshooting

Platform Tools Issues

If automatic installation fails or you prefer manual setup:

  1. Manual Installation via Tool:

    Use setup_platform_tools() tool in Claude
    Use setup_platform_tools(force=true) to re-download
    
  2. Manual Download:

  3. Check Installation Status:

    • Tools install to: ~/.android-debug-mcp/platform-tools/
    • Use setup_platform_tools() to view current installation status

⚠️ Disclaimer

This tool provides low-level access to Android devices. Improper use can:

  • Brick your device
  • Void warranty
  • Erase all data
  • Cause boot loops

USE AT YOUR OWN RISK

🎯 Inspired By

Pixel Flasher - A GUI tool for Android device management

📄 License

MIT