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
- Clone the repository:
- Install dependencies: This project uses uv for project management via various methods of installation.
Configuration
The server uses a simple YAML configuration file (
config.yaml) to specify the
target android deviceCustomizing Configuration
- Create a new configuration file:
- Configure your device:
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:
- Locate your Claude Desktop configuration file:
- Add the Android MCP server configuration to the
mcpServerssection:
Replace:
path/to/uvwith the actual path to youruvexecutable
path/to/android-mcp-serverwith the absolute path to where you cloned this repository
Available Tools
The server exposes the following tools:
Contributing
Contributions are welcome!
Acknowledgments
- Built with Model Context Protocol (MCP)
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
- Clone the repository:
- Install dependencies: This project uses uv for project management via various methods of installation.
Configuration
The server uses a simple YAML configuration file (
config.yaml) to specify the
target android deviceCustomizing Configuration
- Create a new configuration file:
- Configure your device:
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:
- Locate your Claude Desktop configuration file:
- Add the Android MCP server configuration to the
mcpServerssection:
Replace:
path/to/uvwith the actual path to youruvexecutable
path/to/android-mcp-serverwith the absolute path to where you cloned this repository
Available Tools
The server exposes the following tools:
Contributing
Contributions are welcome!
Acknowledgments
- Built with Model Context Protocol (MCP)