This project provides an MCP server for controlling Android devices via ADB, targeting developers and researchers who need programmatic access to device functionalities. It enables remote execution of ADB commands, screenshot capture, UI analysis, and package management, integrating with MCP clients like Claude Desktop.

How It Works

The server acts as an intermediary, translating MCP client requests into ADB commands executed on a connected Android device or emulator. It leverages Python for its implementation and exposes specific tools for interacting with the device, such as execute_adb_command, get_screenshot, get_uilayout, and package management functions. This approach offers a structured and protocol-driven method for Android device automation.

Quick Start & Requirements

• Install dependencies: uv python install 3.11 and uv sync
• Prerequisites: Python 3.x, ADB installed and configured, Android device or emulator.
• Configuration: Create and edit config.yaml to specify the target device name (e.g., "google-pixel-7-pro:5555").
• Integration: Configure MCP clients (e.g., Claude Desktop) to point to the server's execution path.

Highlighted Details

• ADB Command Execution
• Device Screenshot Capture
• UI Layout Analysis
• Device Package Management

Maintenance & Community

This project is maintained by minhalvp. Further community or maintenance details are not specified in the README.

Licensing & Compatibility

The project's license is not explicitly stated in the README. Compatibility for commercial use or closed-source linking is not detailed.

Limitations & Caveats

The README notes that the server has not been tested with physical Android devices or emulators. The specific license and its implications for commercial use are not clarified.