airi-android

🚀 Android 设备的 Airi 服务端

本项目是一个允许 LLM 使用 Android 设备的 MCP 服务器子项目。它是 airi 的子项目，为相关应用在 Android 设备上的运行提供支持。

🚀 快速开始

💻 使用示例

基础用法

使用 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"
      }
    }
  }
}

📦 安装指南

包管理工具

1. 前往 此处 安装 uv。
2. 安装依赖项，执行以下命令：

uv sync

ADB 连接

1. 从 此处 安装 platform-tools。
2. 可使用 USB 将 Android 设备连接到计算机，也可通过 adb connect 使用 AVD（Android 虚拟设备）。

启动服务器

运行 mcp 检查员以启动服务器，执行以下命令：

uv run mcp dev main.py

启动后，可在 http://localhost:6274 打开检查员。