Overview
What is アイリ Android MCP?
アイリ Android MCP is a Model Context Protocol server that allows LLMs to control Android devices. It is a child project of the airi project and provides tools for input control, device information retrieval, UI hierarchy inspection, and shell command execution.
How to use アイリ Android MCP?
The recommended method is Docker (e.g., docker run --rm -it -p 3000:3000 -e ADB_HOST=host.docker.internal ghcr.io/proj-airi/airi-android:v0.3.4). Alternatively, run directly with Bun after installing dependencies (bun install then bun run start). The server supports HTTP mode (default port 3000) and stdio mode (set USE_STDIO=true). Configure mcpServers in your MCP client to point to the server's URL or command.
Key features of アイリ Android MCP
- 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
Use cases of アイリ Android MCP
- Automate UI testing on Android devices through LLM-driven interactions
- Enable AI assistants to perform device setup and configuration tasks
- Collect device diagnostics (battery, CPU, screen info) via natural language prompts
- Remotely control Android emulators or physical devices for development workflows
FAQ from アイリ Android MCP
How does the server connect to an Android device?
The server communicates with an Android device via ADB (Android Debug Bridge). Set the ADB_HOST environment variable to the ADB server's address (default is localhost).
What transport modes are supported?
The server supports both HTTP transport (default, port 3000) and stdio transport (set USE_STDIO=true).
What runtime does the server require?
When running directly (not via Docker), you need Bun installed to start the server or run tests.
Is the project open source? What license?
Yes, the project is licensed under the MIT License.
Can I use this with any LLM that supports MCP?
Yes, the README states it allows "all LLMs" to control Android devices, provided the LLM client supports the Model Context Protocol.
