アイリ Android MCP
About
A MCP server to allow LLM to use Android Device.
Explore
- Tap, swipe, input text, and send key events
- Retrieve physical screen size and display density
- Get CPU usage, core count, and battery information
- Fetch UI hierarchy (XML) and top activities
- Connect to devices by host and port
- Execute arbitrary shell commands on the device
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
アイリ Android MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Install Bun
2. Install Android Platform Tools
3. Connect an Android device (via USB or adb connect for emulators)
bun install
| Variable | Description | Default |
|----------|-------------|---------|
| USE_STDIO | Set to true to use stdio transport mode | false |
| ADB_HOST | ADB server host address | localhost |
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\u30a2\u30a4\u30ea android mcp": {
"airi-android-stdio": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"USE_STDIO=true",
"-e",
"ADB_HOST",
"ghcr.io/proj-airi/airi-android:v0.3.4"
],
"env": {
"ADB_HOST": "host.docker.internal"
}
}
}
}
}McpServers
{
"airi-android-stdio": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"USE_STDIO=true",
"-e",
"ADB_HOST",
"ghcr.io/proj-airi/airi-android:v0.3.4"
],
"env": {
"ADB_HOST": "host.docker.internal"
}
}
}
A MCP server that allows ~~airi~~ all LLMs to control Android devices. This project is a child project of airi.
Features
Input Control
-input_tap - Tap on the screen at given coordinates
- input_swipe - Swipe from one coordinate to another
- input_text - Input text on the device
- input_keyevent - Send a key event to the device
- input_press - Press the current key
- input_roll - Roll the trackball
Device Information
-wm_size - Get the physical screen size
- wm_density - Get the display density
- cpu_percent - Get CPU usage percentage
- cpu_count - Get the number of CPU cores
- battery_level - Get battery level
- battery_stats - Get detailed battery statistics
UI & Activity
-ui_get_hierarchy - Get UI hierarchy (XML)
- utils_top_activity - Get the top activity
- utils_top_activities - Get all top activities
- utils_package_version - Get package version info
Device Management
-device_connect - Connect to a device at specified host and port
- device_reset - Reset device connection
- shell_execute - Execute any shell command
Usage
Docker (Recommended)
```bash docker run --rm -it -p 3000:3000 -e ADB_HOST=host.docker.internal ghcr.io/proj-airi/airi-android:v0.3.4Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
