README.md•1.91 kB
# Android Mobile MCP
## Overview
Android Mobile MCP bridges the Model Context Protocol with Android device automation, enabling AI agents to interact with Android devices through UI manipulation, app management, and screen capture.
## MCP Configuration
```json
{
"mcpServers": {
"android-mobile-mcp": {
"command": "uvx",
"args": ["android-mobile-mcp"]
}
}
}
```
### Prerequisites
1. Connect Android device via USB or network
2. Enable USB debugging on your Android device
3. Install ADB (Android Debug Bridge)
## Tools Reference
### Screen Analysis
**`mobile_dump_ui`** - Extract UI elements as hierarchical JSON
- Parses screen XML to identify focusable elements and text content
- Calculates center coordinates for each interactive element
- Returns structured parent-child element relationships
**`mobile_take_screenshot`** - Capture current screen state
- Returns PNG image data for visual analysis
### Touch Interactions
**`mobile_click`** - Click at specific coordinates
- Validates coordinates against current UI state
- Requires prior `mobile_dump_ui` call for coordinate verification
- Prevents clicking on invalid or non-interactive areas
**`mobile_swipe`** - Perform swipe gestures
- Executes directional swipes between two coordinate points
- Configurable duration for gesture speed control
### Text Input
**`mobile_type`** - Input text into focused fields
- Sends text to currently active input field
- Optional automatic submission with Enter key
### Navigation
**`mobile_key_press`** - Press system buttons
- Supports hardware and virtual keys: BACK, HOME, RECENT, ENTER
### App Management
**`mobile_list_apps`** - List installed applications
- Filters out system apps and non-launchable packages
- Returns only user-accessible applications
**`mobile_launch_app`** - Start applications by package name
- Validates package existence before launch attempt