airi-android

airi-android

1
os_automationdeveloper_tools

Airi Android is a Model Context Protocol server designed to integrate Language Model applications with Android devices. It serves as a subproject of the airi project, facilitating seamless interaction between LLM services and Android functionalities.

アイリ 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",
        "--init",
        "-i",
        "-e",
        "ADB_HOST",
        "ghcr.io/lemonnekogh/airi-android:v0.2.1"
      ],
      "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 src/main.py

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