mcp-server-adb

What is mcp-server-adb?

mcp-server-adb is a TypeScript-based Model Context Protocol server that enables AI assistants to control Android devices through Android Debug Bridge (ADB) commands. It provides resources for device discovery, tools for device operations, and prompts for device and app analysis.

How to use mcp-server-adb?

Install Node.js 16+ and ensure ADB is available in your PATH. Clone the repository, run npm install and npm run build. Then add the built server (path to build/index.js) to the mcpServers section of your Claude Desktop configuration file (claude_desktop_config.json). Enable USB debugging on your Android device and connect it via USB or network ADB.

Key features of mcp-server-adb

• Resources for device list, info, packages, and screenshots
• Tools to connect/disconnect devices, tap, swipe, input text, and press keys
• Take screenshots directly via a dedicated tool
• Prompts for analyzing device status, installed apps, and screen content
• Coming soon: install, uninstall, start, and stop applications

Use cases of mcp-server-adb

• Automate repetitive device interactions like taps and text input during testing
• Capture and analyze screen content for debugging or UI verification
• Retrieve detailed device information and installed package lists for inventory
• Enable AI-driven remote control of Android devices for diagnostics

FAQ from mcp-server-adb

What are the prerequisites to run mcp-server-adb?

Node.js 16 or higher, ADB installed and available in your system PATH, and an Android device with USB debugging enabled or network ADB enabled.

How do I connect to an Android device?

Enable USB debugging in Developer options on the device, then connect via USB. For wireless debugging, first connect via USB, enable Wireless debugging in Developer options, and use the connect_device tool with the device’s IP address.

Are app management tools (install/uninstall) available now?

No, those tools are listed as “Coming Soon” in the current README. Only device control and screen interaction tools are implemented.

How can I debug the MCP server?

Use the MCP Inspector by running npm run inspector in the project directory. It provides a browser-based debugging interface for MCP servers that communicate over stdio.

Where is the Claude Desktop configuration file stored?

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows: %APPDATA%/Claude/claude_desktop_config.json.