アイリ Android
About
アイリ Android is an MCP (Model Context Protocol) server that allows large language models (LLMs) to control Android devices. It is a child project of airi and provides tools for input control, device information retrieval, UI hierarchy extraction, and shell command execution.
Details
- Author
- LemonNekoGH
- GitHub stars
- 14
- Downloads
- 443
- Categories
- Other, AI
Jump to
- Input control: tap, swipe, text, keyevent, press, roll
- Device information: screen size, density, CPU, battery
- UI hierarchy XML retrieval and activity inspection
- Shell command execution on the device
- Device connection management (connect and reset)
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
アイリ AndroidCommand (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
You can run アイリ Android either via Docker (recommended) or directly using Bun. In Docker, set the ADB_HOST environment variable and optionally USE_STDIO=true for stdio transport. For direct usage, install Bun and Android Platform Tools, connect an Android device (USB or ADB), then run bun run start (HTTP mode) or USE_STDIO=true bun run start (stdio mode). Configure your MCP client with the appropriate mcp.json entry as shown in the README.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\u30a2\u30a4\u30ea android": {
"airi-android-lemonnekogh": {
"command": "uv",
"args": [
"sync"
]
}
}
}
}McpServers
{
"airi-android-lemonnekogh": {
"command": "uv",
"args": [
"sync"
]
}
}アイリ Android
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.4
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
