アイリ Android MCP

アイリ Android

airiすべてのLLMがAndroidデバイスを操作できるようにするMCP サーバーです。このプロジェクトはairiの子プロジェクトです。

機能

入力制御

• input_tap - 指定した座標を画面上でタップします
• input_swipe - ある座標から別の座標までスワイプします
• input_text - デバイスにテキストを入力します
• input_keyevent - デバイスにキーイベントを送信します
• input_press - 現在のキーを押します
• input_roll - トラックボールを回転させます

デバイス情報

• wm_size - 物理画面サイズを取得します
• wm_density - ディスプレイ密度を取得します
• cpu_percent - CPU使用率を取得します
• cpu_count - CPUコア数を取得します
• battery_level - バッテリー残量を取得します
• battery_stats - 詳細なバッテリー統計情報を取得します

UIとアクティビティ

• ui_get_hierarchy - UI階層（XML）を取得します
• utils_top_activity - 最前面のアクティビティを取得します
• utils_top_activities - すべての最前面のアクティビティを取得します
• utils_package_version - パッケージのバージョン情報を取得します

デバイス管理

• device_connect - 指定したホストとポートでデバイスに接続します
• device_reset - デバイス接続をリセットします
• shell_execute - 任意のシェルコマンドを実行します

使用方法

Docker（推奨）

docker run --rm -it -p 3000:3000 -e ADB_HOST=host.docker.internal ghcr.io/proj-airi/airi-android:v0.3.4
# or stdio mode
docker run --rm -i -e USE_STDIO=true -e ADB_HOST=host.docker.internal ghcr.io/proj-airi/airi-android:v0.3.4

MCPに対応したエージェントでは、次の設定を使用できます。

// mcp.json
{
  "mcpServers": {
    // http mode
    "airi-android-http": {
      "url": "http://localhost:3000/mcp"
    },
    // stdio mode
    "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"
      }
    }
  }
}

直接実行

Bunのインストールが必要です。

# Install dependencies
bun install

# Start server (HTTP mode, port 3000)
bun run start

# Or use stdio mode
USE_STDIO=true bun run start

開発環境のセットアップ

前提条件

1. Bunをインストールします
2. Android Platform Toolsをインストールします
3. Androidデバイスを接続します（USB経由、またはエミュレーターの場合はadb connectを使用）

コマンド

# Install dependencies
bun install

# Run tests
bun test

# Start development server
bun run dev

# Build binary
bun run build

# Lint code
bun run lint

# Type check
bun run typecheck

貢献

コードのガイドラインについては、AGENTS.mdを参照してください。

環境変数

変数	説明	デフォルト
USE_STDIO	stdioトランスポートモードを使用するにはtrueに設定します	false
ADB_HOST	ADBサーバーのホストアドレス	localhost

技術スタック

• Bun - JavaScriptランタイム
• TypeScript - 型安全なJavaScript
• MCP SDK - Model Context Protocol SDK
• adbkit - ADBクライアントライブラリ
• Hono - Webフレームワーク
• Zod - スキーマ検証

ライセンス

MIT