lukaj99/android-debug-mcp-server
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.
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
- Node.js 18+
- Android Platform Tools (ADB & Fastboot) - Auto-installed on first use!
- Tools are automatically downloaded to
~/.android-debug-mcp/platform-tools/
- Manual setup: Use the
setup_platform_tools()
tool - Or download manually: https://developer.android.com/tools/releases/platform-tools
- Tools are automatically downloaded to
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:
-
Manual Installation via Tool:
Use setup_platform_tools() tool in Claude Use setup_platform_tools(force=true) to re-download
-
Manual Download:
- Download from: https://developer.android.com/tools/releases/platform-tools
- Extract to any location
- Set environment variables in Claude Desktop config:
"env": { "ADB_PATH": "/path/to/platform-tools/adb", "FASTBOOT_PATH": "/path/to/platform-tools/fastboot" }
-
Check Installation Status:
- Tools install to:
~/.android-debug-mcp/platform-tools/
- Use
setup_platform_tools()
to view current installation status
- Tools install to:
⚠️ 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