MCP plugin to control Android devices via ADB for automation, testing, and agent integration
npm install android-debug-bridge-mcpMCP plugin to control Android devices via ADB for automation, testing, and agent integration.
Install the package globally via npm:
``bash`
npm install -g android-debug-bridge-mcp
Add to your MCP configuration in ~/.claude/mcp_servers.json:
`json`
{
"mcpServers": {
"android-debug-bridge": {
"command": "npx",
"args": ["android-debug-bridge-mcp"]
}
}
}
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-bridgenpx
- Command: ["android-debug-bridge-mcp"]
- Args:
Add to your MCP configuration file:
Windows: %APPDATA%\Claude\claude_desktop_config.json~/Library/Application Support/Claude/claude_desktop_config.json
macOS: ~/.config/Claude/claude_desktop_config.json
Linux:
`json``
{
"mcpServers": {
"android-debug-bridge": {
"command": "npx",
"args": ["android-debug-bridge-mcp"]
}
}
}
- 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
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)
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"
- ...
MIT