Happy slice of mcp pizzaMCP.pizza

android-mcp-server

MCP.Pizza Chef: minhalvp

Communication with a connected Android phone or emulator happens through ADB, the standard Android debugging tool. An assistant can take a screenshot, list what is tappable on screen, see which apps are installed, and run device commands you describe in words. It is aimed at people testing apps rather than at everyday phone use. Setup is hands-on: you clone the project, install Python, uv, and ADB, then add a configuration block pointing at the folder. No account or key is needed.

Unmaintained · No commits in 15 months.
Coding
Other

Use This MCP server To

Take a screenshot of my phone without touching it List what is tappable on the screen right now See which apps are installed on a test device Walk through an app's screens while I read the results Run a device command I described in plain words

README

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

  1. Clone the repository:
git clone https://github.com/minhalvp/android-mcp-server.git
cd android-mcp-server
  1. Install dependencies: This project uses uv for project management via various methods of installation.
uv python install 3.11
uv sync

Configuration

The server supports flexible device configuration with multiple usage scenarios.

Device Selection Modes

1. Automatic Selection (Recommended for single device)

  • No configuration file needed
  • Automatically connects to the only connected device
  • Perfect for development with a single test device

2. Manual Device Selection

  • Use when you have multiple devices connected
  • Specify exact device in configuration file

android-mcp-server FAQ

Which apps does this work with?
Claude Desktop and Cursor are named in the readme, and other MCP-capable tools should work too.
Do I need an API key?
No, but you do need ADB installed and a phone or emulator connected with debugging turned on.
Can I use this to check an app on my phone hands-free?
Yes — it can screenshot the screen, list the on-screen buttons, and issue device commands while you read the output.
How hard is setup?
This one is for developers: clone the repository, install Python and the uv tool, set up ADB, and edit a config file with absolute paths.
What if I have several devices plugged in?
With one device it connects automatically. With several, you name the one you want in a small config file, otherwise it shows an error listing them.
How polished is it?
The prerequisites list marks the device or emulator side as untested, so expect rough edges.