DroidLume Agent Control

English · 简体中文

Распространяемый через npm CLI и MCP-сервер, а также стандартный Agent Skill для DroidLume.

DroidLume Agent Control позволяет Codex, Claude Code, Cursor, Gemini и другим AI-агентам управлять локальными виртуальными Android-устройствами, которыми управляет DroidLume. Он объединяет структурированный CLI, локальный MCP-сервер, macOS App Intents и открытый Agent Skill, не полагаясь на хрупкую автоматизацию по координатам экрана.

Что он умеет

• Создавать, клонировать, настраивать, запускать, останавливать, перезапускать, восстанавливать, показывать и удалять Android-устройства

• Устанавливать APK-файлы через потоковую загрузку в песочницу

• Выводить список, запускать, останавливать и удалять Android-приложения

• Вводить текст, нажимать по координатам, выполнять свайпы и отправлять Android key events

• Захватывать скриншоты Android в формате PNG или как нативный MCP image content

• Экспортировать диагностику DroidLume с удалением конфиденциальных данных

• Возвращать стабильные идентификаторы устройств, типизированный JSON, схемы команд, таймауты и структурированные ошибки

Related MCP server: adb-mcp-server

Требования

• Mac на Apple silicon

• macOS 14 или новее

• DroidLume 1.1 или новее

• Node.js 20 или новее

Установка

Установите CLI и MCP-сервер из npm, затем установите Skill для вашего агента:

npm install --global droidlume-agent-control
droidlume agent install codex

Или запустите поддерживаемый установщик, который выполняет те же два шага:

curl -fsSL https://raw.githubusercontent.com/tageecc/droidlume-agent-control/main/install.sh | zsh -s -- codex

Целевые платформы:

all | codex | claude | cursor | agents

Проверьте установку:

droidlume version
droidlume status --format pretty
droidlume device list --format pretty

Настройка MCP

Сгенерируйте фрагмент конфигурации MCP:

droidlume agent config

Рекомендуемая конфигурация без вручную загруженного ZIP:

{
  "mcpServers": {
    "droidlume": {
      "command": "npx",
      "args": ["-y", "droidlume-agent-control", "mcp"]
    }
  }
}

MCP-сервер использует stdio и предоставляет 23 типизированных инструмента, три ресурса и подсказку для проверки Android-приложений. Скриншоты возвращаются как нативный MCP-контент image/png.

Примеры CLI

Запустите устройство и откройте его окно:

droidlume device start DEVICE_ID --show --timeout 180

Установите и запустите APK:

droidlume app install DEVICE_ID /absolute/path/application.apk --timeout 300
droidlume app launch DEVICE_ID com.example.app

Проверьте экран Android:

droidlume device screenshot DEVICE_ID --output screen.png
droidlume input tap DEVICE_ID 540 1200
droidlume device screenshot DEVICE_ID --output screen-after.png

Прочитайте машинный контракт перед автоматизацией:

droidlume schema
droidlume schema device start

См. полный каталог команд, руководство по MCP, правила состояния и безопасности и справочник ошибок.

Архитектура

Codex / Claude / Gemini / Cursor / CI
                    │
        Agent Skill / npm MCP / npm CLI
                    │
       DroidLume Control API v1.0
          http://127.0.0.1:55777
                    │
          DroidLume RuntimeController
                    │
             Managed Android devices

Публичный CLI и MCP-сервер взаимодействуют с основным приложением DroidLume через loopback. Жизненный цикл устройств, установка приложений, скриншоты, ввод и диагностика по-прежнему выполняются через тот же RuntimeController, который используется нативным интерфейсом macOS.

Почему DroidLume Agent Control

Универсальная автоматизация Android часто раскрывает сырые ADB-серийники или зависит от координат скриншотов. Вместо этого DroidLume предоставляет контракт управления на уровне продукта:

• стабильные UUID устройств вместо временных серийников эмулятора;

• управление жизненным циклом с поддержкой start, stop, restart, repair и Quick Boot;

• потоковая загрузка APK в песочницу DroidLume;

• структурированное обнаружение команд и ошибок;

• единая плоскость управления для нативного приложения, CLI, MCP и Shortcuts.

FAQ

Это эмулятор Android?

DroidLume — это приложение для виртуальных Android-устройств. Этот репозиторий предоставляет npm-реализацию CLI/MCP и Agent Skill для его автоматизации; это не второе приложение для macOS.

Использует ли он сырой ADB в качестве публичного интерфейса?

Нет. AI-клиенты вызывают версионированный API управления DroidLume. Основное приложение владеет своим приватным пространством имён ADB и жизненным циклом управляемых устройств.

Какие AI-инструменты поддерживаются?

Agent Skill соответствует открытому формату SKILL.md. CLI работает из любой оболочки, а MCP-сервер работает с клиентами, поддерживающими MCP, включая Codex, Claude Code, Cursor и инструментарий Gemini.

Инструмент локальный?

Да. Конечная точка управления хостом DroidLume прослушивает 127.0.0.1, а droidlume-mcp использует локальный stdio-транспорт.

Ссылки

• Официальный сайт DroidLume

• Документация Agent Control

• npm-пакет

• Поддержка

Лицензия

Agent Skill и документация в этом репозитории доступны по лицензии MIT. Двоичные файлы приложения DroidLume и товарные знаки остаются предметом соответствующих условий на продукт.