ADB MCP Server

What is ADB MCP Server?

ADB MCP Server is a Model Context Protocol (MCP) server that manages Android Debug Bridge (ADB) connections and interacts with Android devices. It enables AI assistants to list devices, capture screenshots, inspect UI hierarchies, and execute arbitrary ADB commands through standard MCP tools.

How to use ADB MCP Server?

Ensure ADB is installed and added to your PATH, Node.js v14+ and TypeScript are available. Clone the repository, run npm install, then npm run build. Start the server with npm start. The server communicates over stdio and exposes four MCP tools: get_devices, capture_screenshot, get_ui_elements, and execute_adb_command.

Key features of ADB MCP Server

• List all connected Android devices with IDs and states
• Capture screenshots from connected devices
• Extract full UI hierarchy in XML format
• Execute arbitrary ADB commands on a device

Use cases of ADB MCP Server

• Automate screenshot capture for documentation or testing
• Retrieve UI element information for UI automation
• Run custom ADB commands for device management
• Integrate Android device control into AI-powered workflows

FAQ from ADB MCP Server

What is ADB MCP Server used for?

It allows an AI assistant to manage Android devices via ADB, performing tasks like listing devices, taking screenshots, inspecting UI elements, and executing ADB commands.

What are the prerequisites to run ADB MCP Server?

Your system must have Android Debug Bridge (ADB) installed and in the PATH, plus Node.js (v14 or higher) and TypeScript.

How do I start ADB MCP Server?

Clone the repository, install dependencies (npm install), build the project (npm run build), then start with npm start. For development with auto-reload, use npm run dev.

What tools does ADB MCP Server provide?

Four MCP tools: get_devices, capture_screenshot, get_ui_elements, and execute_adb_command. Each tool accepts parameters like deviceId and, for screenshots, a path.

How do I capture a screenshot with ADB MCP Server?

Use the capture_screenshot tool, providing the target deviceId and a path where the screenshot will be saved. The file is named in the format YYYYMMDD_HH_MM_SS.png.