minhalvp/android-mcp-server

An MCP (Model Context Protocol) server that provides programmatic control over
Android devices through ADB (Android Debug Bridge). This server exposes
various Android device management capabilities that can be accessed by MCP
clients like Claude desktop
and Code editors
(e.g. Cursor)
Features
- 🔧 ADB Command Execution
- 📸 Device Screenshot Capture
- 🎯 UI Layout Analysis
- 📱 Device Package Management
Prerequisites
- Python 3.x
- ADB (Android Debug Bridge) installed and configured
- Android device or emulator (not tested)
Installation
1. Clone the repository:
2. Install dependencies:
This project uses uv for project
management via various methods of
installation.
Configuration
The server supports flexible device configuration with multiple usage scenarios.
Device Selection Modes
**1. Automatic Selection (Recommended for single device)**
- No configuration file needed
- Automatically connects to the only connected device
- Perfect for development with a single test device
**2. Manual Device Selection**
- Use when you have multiple devices connected
- Specify exact device in configuration file
Configuration File (Optional)
The configuration file (config.yaml) is **optional**. If not present, the server will automatically select the device if only one is connected.
For Automatic Selection
Simply ensure only one device is connected and run the server - no configuration needed!
For Manual Selection
1. Create a configuration file:
2. Edit config.yaml and specify your device:
**For auto-selection**, you can use any of these methods:
Finding Your Device Serial
To find your device identifier, run:
Example output:
Use the first column value (e.g., 13b22d7f or emulator-5554) as the device name.
Usage Scenarios
| Scenario | Configuration Required | Behavior |
|----------|----------------------|----------|
| Single device connected | None | ✅ Auto-connects to the device |
| Multiple devices, want specific one | config.yaml with device.name | ✅ Connects to specified device |
| Multiple devices, no config | None | ❌ Shows error with available devices |
| No devices connected | N/A | ❌ Shows "no devices" error |
**Note**: If you have multiple devices connected and don't specify which one to use, the server will show an error message listing all available devices.
Usage
An MCP client is needed to use this server. The Claude Desktop app is an example
of an MCP client. To use this server with Claude Desktop: