MCP server for Android device automation via ADB
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mcp-server-android","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# 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](https://modelcontextprotocol.io/quickstart/user) and Code editors (e.g. [Cursor](https://docs.cursor.com/context/model-context-protocol)) ## Features - 🔧 ADB Command Execution - 📸 Device Screenshot Capture - 🎯 UI Layout Analysis - 📱 Device Package Management - 🚀 **NEW:** Automatic Emulator Startup - 🎮 **NEW:** Emulator Management Tools ## Prerequisites - Python 3.11+ - ADB (Android Debug Bridge) installed and configured - Android device (physical or emulator) ## Installation ### Quick Install (Recommended) ```bash # Using uvx (no installation needed) uvx mcp-server-android # Or using pip pip install mcp-server-android # Or using uv tool uv tool install mcp-server-android ``` ### Development Installation 1. Clone the repository: ```bash git clone https://github.com/minhalvp/android-mcp-server.git cd android-mcp-server ``` 2. Install dependencies: This project uses [uv](https://github.com/astral-sh/uv) for project management via various methods of [installation](https://docs.astral.sh/uv/getting-started/installation/). ```bash uv python install 3.11 uv sync ``` ## Configuration The server supports flexible device configuration with multiple usage scenarios. ### Environment Variables You can configure the server using environment variables: - `ANDROID_DEVICE_SERIAL` - Specify the device serial (overrides config file) - `ANDROID_MCP_CONFIG` - Path to custom config file (default: `config.yaml`) - `ANDROID_AUTO_START_EMULATOR` - Enable/disable auto-start emulator (default: `true`) Example: ```bash export ANDROID_DEVICE_SERIAL="emulator-5554" uvx mcp-server-android ``` ### Device Selection Modes **1. Automatic Selection (Recommended for single device)** - No configuratio…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.