アイリ Android

A MCP server to allow airi LLM to use Android Device. This project is child project of airi.

Usage

With Docker:

// mcp.json
{
  "mcpServers": {
    "airi-android": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "ADB_HOST",
        "ghcr.io/lemonnekogh/airi-android:v0.1.0"
      ],
      "env": {
        "ADB_HOST": "host.docker.internal"
      }
    }
  }
}

Setup development environment

Package manager

1. Install uv here.

2. Install dependencies.

   uv sync
   

ADB connection

1. Install platform-tools from here.
2. Connect your Android device via USB, or use the AVD (Android Virtual Device) via adb connect.

Start the server

Run the mcp inspector it will start the server.

uv run mcp dev main.py

Open the inspector at http://localhost:6274.