DroidLume Agent Control

English · 简体中文

CLI y servidor MCP distribuidos vía npm, además de un Agent Skill estándar para IA, para DroidLume.

DroidLume Agent Control permite que Codex, Claude Code, Cursor, Gemini y otros agentes de IA controlen dispositivos Android virtuales locales gestionados por DroidLume. Combina un CLI estructurado, un servidor MCP local, App Intents de macOS y un Agent Skill abierto, sin depender de una automatización frágil basada en coordenadas de pantalla.

Qué puede hacer

• Crear, clonar, configurar, iniciar, detener, reiniciar, reparar, mostrar y eliminar dispositivos Android

• Instalar archivos APK mediante una subida en streaming al sandbox

• Listar, lanzar, detener y desinstalar aplicaciones Android

• Escribir texto, tocar coordenadas, deslizar y enviar eventos de teclado de Android

• Capturar capturas de pantalla de Android como PNG o contenido nativo de imagen MCP

• Exportar diagnósticos de DroidLume con información sensible redactada

• Devolver IDs de dispositivo estables, JSON tipado, esquemas de comandos, tiempos de espera y errores estructurados

Related MCP server: adb-mcp-server

Requisitos

• Mac con chip Apple silicon

• macOS 14 o posterior

• DroidLume 1.1 o posterior

• Node.js 20 o posterior

Instalación

Instala el CLI y el servidor MCP desde npm y, a continuación, instala el Skill para tu agente:

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

O ejecuta el instalador mantenido, que realiza los mismos dos pasos:

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

Destinos:

all | codex | claude | cursor | agents

Verifica la instalación:

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

Configuración de MCP

Genera un fragmento de configuración de MCP:

droidlume agent config

Configuración recomendada sin un ZIP descargado manualmente:

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

El servidor MCP usa stdio y expone 23 herramientas tipadas, tres recursos y un prompt de inspección de aplicaciones Android. Las capturas de pantalla se devuelven como contenido nativo image/png de MCP.

Ejemplos de CLI

Inicia un dispositivo y abre su ventana:

droidlume device start DEVICE_ID --show --timeout 180

Instala y lanza un APK:

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

Inspecciona la pantalla de 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

Lee el contrato de la máquina antes de la automatización:

droidlume schema
droidlume schema device start

Consulta el catálogo completo de comandos, la guía de MCP, las reglas de estado y seguridad y la referencia de errores.

Arquitectura

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

El CLI público y el servidor MCP se comunican con la aplicación host de DroidLume a través de loopback. El ciclo de vida de los dispositivos, la instalación de aplicaciones, las capturas de pantalla, la entrada y los diagnósticos siguen ejecutándose a través del mismo RuntimeController que utiliza la interfaz nativa de macOS.

Por qué DroidLume Agent Control

La automatización genérica de Android a menudo expone seriales ADB crudos o depende de coordenadas de captura de pantalla. DroidLume ofrece en su lugar un contrato de control a nivel de producto:

• UUIDs de dispositivo estables en lugar de seriales de emulador transitorios;

• gestión de inicio, detención, reinicio, reparación y Quick Boot consciente del ciclo de vida;

• subida de APK en streaming al sandbox de DroidLume;

• descubrimiento de comandos y errores estructurados;

• un plano de control compartido por la aplicación nativa, el CLI, MCP y Shortcuts.

Preguntas frecuentes

¿Es esto un emulador de Android?

DroidLume es la aplicación de dispositivos virtuales Android. Este repositorio proporciona la implementación del CLI/MCP de npm y el Agent Skill utilizados para automatizarla; no es una segunda aplicación de macOS.

¿Usa ADB crudo como interfaz pública?

No. Los clientes de IA llaman a la API de control de DroidLume versionada. La aplicación host posee su propio espacio de nombres ADB privado y el ciclo de vida de los dispositivos gestionados.

¿Qué herramientas de IA son compatibles?

El Agent Skill sigue el formato abierto SKILL.md. El CLI funciona desde cualquier shell, y el servidor MCP funciona con clientes compatibles con MCP, incluidos Codex, Claude Code, Cursor y las herramientas de Gemini.

¿La herramienta es local?

Sí. El endpoint de control del host de DroidLume escucha en 127.0.0.1, y droidlume-mcp usa transporte stdio local.

Enlaces

• Sitio web oficial de DroidLume

• Documentación de Agent Control

• Paquete npm

• Soporte

Licencia

El Agent Skill y la documentación de este repositorio están disponibles bajo la Licencia MIT. Los binarios y marcas comerciales de la aplicación DroidLume siguen sujetos a sus respectivos términos de producto.