Android MCP Server

MCP server providing ADB and scrcpy capabilities for Android device control. Built with FastMCP.

Assisted by Minimax Model via Claude Code.

Features

• Device Management: List devices, get device info
• App Management: Install/uninstall apps, start/stop apps, list packages
• File Operations: Push/pull files between device and host
• Shell Execution: Run shell commands on device, exec-out for binary output
• Input Control: Tap, swipe, input text, press keys
• System Info: Screen size, battery status, system properties
• Screen Control: Screen mirroring and control via scrcpy, screenshot via exec-out
• UI Element Finding: Dump UI hierarchy, find elements by attributes

Install

uv add android-mcp-server

Or install from source:

# Clone the repo, then install
git clone https://github.com/chldu2000/android-mcp-server.git
cd android-mcp-server
uv pip install -e .
uv run python -m android_mcp.main

Add MCP Server

Claude Code

claude mcp add android uv run -- python -m android_mcp.main --cwd /Path/to/workdir

Other MCP Clients

The server can be run with:

uv run python -m android_mcp.main

Tools

Device Management

Tool	Description
adb_list_devices	List all connected Android devices
adb_device_info	Get detailed device information

App Management

Tool	Description
adb_install_app	Install an APK
adb_uninstall_app	Uninstall an application
adb_list_packages	List installed packages
adb_start_app	Start an application
adb_stop_app	Force stop an application

File Operations

Tool	Description
adb_pull_file	Pull file from device
adb_push_file	Push file to device

Shell

Tool	Description
adb_shell	Execute shell command
adb_exec_out	Execute command via exec-out (for binary output)

Input Control

Tool	Description
adb_tap	Tap at coordinates
adb_swipe	Swipe gesture
adb_input_text	Input text
adb_press_key	Press key event

System Info

Tool	Description
adb_get_screen_size	Get screen resolution
adb_get_battery	Get battery status
adb_get_properties	Get system properties

Screen Control (scrcpy)

Tool	Description
scrcpy_start	Start screen mirroring
scrcpy_stop	Stop screen mirroring
scrcpy_screenshot	Take screenshot
scrcpy_control	Send control command
adb_screencap	Capture screenshot via exec-out

UI Elements

Tool	Description
adb_dump_ui_tree	Dump UI hierarchy tree
adb_find_element	Find UI elements by attributes

Device Connection

USB Devices

Connect via USB and ensure USB debugging is enabled on the device.

Network Devices

For TCP/IP connection:

1. Enable TCP/IP mode on device:

   adb tcpip 5555
   

2. Find device IP:

   adb shell ip route
   

3. Connect:

   adb connect <device-ip>:5555
   

Dependencies

• fastmcp - MCP server framework
• scrcpy - Screen mirroring (must be installed separately)
• uiautomator2 - uiautomator2 Python wrapper