# Android MCP Server
This is a Model Context Protocol (MCP) server that enables control of Android devices using `uiautomator2`.
## Prerequisites
- Python 3.10+
- ADB installed and added to PATH
- An Android device connected via USB or WiFi (with ADB debugging enabled)
## Installation
1. Create a virtual environment:
```bash
python -m venv venv
.\venv\Scripts\activate
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
## Usage
To run the server:
```bash
python main.py
```
### Tools Available
- `connect_device(serial)`: Connect to a device.
- `device_info()`: Get device status.
- `dump_hierarchy()`: View UI XML.
- `click_element(text, resource_id, description)`: Click UI elements.
- `wait_for_element(text, resource_id, description, timeout)`: Wait for element to appear.
- `click_point(x, y)`: Click at coordinates.
- `swipe(sx, sy, ex, ey)`: Swipe gesture.
- `input_text(text, clear)`: Type text.
- `press_key(key)`: Press physical keys (home, back, etc.).
- `open_app(package_name)`: Launch an app.
- `stop_app(package_name)`: Stop an app.
- `install_app(url_or_path)`: Install APK.
- `uninstall_app(package_name)`: Uninstall app.
- `shell_command(command)`: Run ADB shell command.
- `take_screenshot()`: Capture screen.
## Configuration
Ensure your device is visible via `adb devices` before connecting.
### Gemini MCP Configuration
To use this server with Gemini CLI or compatible MCP clients, add the following to your MCP configuration file (e.g., `~/.gemini/settings.json`):
```json
"android": {
"command": "d:\\src\\android-mcp\\venv\\Scripts\\python.exe",
"args": [
"d:\\src\\android-mcp\\main.py"
]
}
```
Replace the paths with the actual absolute paths to your project if they differ.
