アイリ Android MCP

Name: アイリ Android MCP
Author: proj-airi

@proj-airi

Repository

About アイリ Android MCP

A MCP server to allow LLM to use Android Device.

#android #adb #airi

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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