アイリ Android

Name: アイリ Android
Author: LemonNekoGH

@LemonNekoGH

リポジトリ

アイリ Android について

Allow LLM to use Android Device

#android #adb #airi #llm #mcp-server

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

node

トランスポート

stdio

公開者

LemonNekoGH

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "airi-android-lemonnekogh": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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