アイリ Android

What is アイリ Android?

アイリ 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.

How to use アイリ Android?

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.

Key features of アイリ Android

• 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)

Use cases of アイリ Android

• Automate Android device input for testing or accessibility
• Retrieve device status (battery, CPU, screen) via LLM queries
• Perform UI hierarchy analysis for app interaction
• Execute shell commands remotely through AI assistants
• Manage multiple device connections and switch between them

FAQ from アイリ Android

What are the prerequisites for running アイリ Android?

You need Bun installed for direct mode, or Docker for containerized mode. An Android device must be connected via USB or emulator (via adb connect). Android Platform Tools are required for direct usage.

How do I run アイリ Android in HTTP mode?

Use the Docker command: docker run --rm -it -p 3000:3000 -e ADB_HOST=host.docker.internal ghcr.io/proj-airi/airi-android:v0.3.4. Or directly: bun run start (listens on port 3000).

How do I configure my MCP client?

Add an entry to your mcp.json file. For HTTP mode, set "url": "http://localhost:3000/mcp". For stdio mode, use the docker run command with USE_STDIO=true as the command and args, and an env for ADB_HOST.

What transport modes are available?

Two modes: HTTP (default, port 3000) and stdio (set USE_STDIO=true environment variable). The stdio mode is suitable for MCP clients that spawn processes.

How do I connect to an Android device?

Ensure ADB is available and the device is reachable. For USB-connected devices, ADB detects them automatically. For emulators, use adb connect. The ADB_HOST environment variable specifies the ADB server address (default localhost).