アイリ Android MCP

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

@proj-airi

代码仓库

关于アイリ Android MCP

A MCP server to allow LLM to use Android Device.

#android #adb #airi

基本信息

分类

其他

传输方式

stdio

发布者

proj-airi

提交者

LemonNeko

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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