erichung9060/Android-Mobile-MCP

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

{
  "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