DroidLume Agent Control

English · 简体中文

CLI und MCP-Server, über npm verteilt, sowie eine standardkonforme AI Agent Skill für DroidLume.

DroidLume Agent Control ermöglicht Codex, Claude Code, Cursor, Gemini und anderen KI-Agenten die Steuerung lokaler Android-Virtualgeräte, die von DroidLume verwaltet werden. Es kombiniert eine strukturierte CLI, einen lokalen MCP-Server, macOS-App-Intents und eine offene Agent Skill, ohne auf störanfällige Automatisierung auf Basis von Bildschirmkoordinaten angewiesen zu sein.

Was es kann

• Android-Geräte erstellen, klonen, konfigurieren, starten, stoppen, neu starten, reparieren, anzeigen und löschen

• APK-Dateien über einen gestreamten Sandbox-Upload installieren

• Android-Apps auflisten, starten, stoppen und deinstallieren

• Text eingeben, Koordinaten antippen, wischen und Android-Tastenevents senden

• Android-Screenshots als PNG oder nativen MCP-Bildinhalt erfassen

• Redigierte DroidLume-Diagnosen exportieren

• Stabile Geräte-IDs, typisiertes JSON, Befehls-Schemas, Timeouts und strukturierte Fehler zurückgeben

Related MCP server: adb-mcp

Anforderungen

• Apple-Silicon-Mac

• macOS 14 oder neuer

• DroidLume 1.1 oder neuer

• Node.js 20 oder neuer

Installation

Installieren Sie die CLI und den MCP-Server über npm und installieren Sie anschließend die Skill für Ihren Agenten:

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

Oder führen Sie den gepflegten Installer aus, der dieselben beiden Schritte durchführt:

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

Zielplattformen:

all | codex | claude | cursor | agents

Überprüfen Sie die Installation:

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

MCP-Einrichtung

Generieren Sie einen MCP-Konfigurationsausschnitt:

droidlume agent config

Empfohlene Konfiguration ohne manuell heruntergeladene ZIP:

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

Der MCP-Server verwendet stdio und stellt 23 typisierte Tools, drei Ressourcen und einen Prompt zur Android-App-Inspektion bereit. Screenshots werden als nativer image/png-MCP-Inhalt zurückgegeben.

CLI-Beispiele

Starten Sie ein Gerät und öffnen Sie dessen Fenster:

droidlume device start DEVICE_ID --show --timeout 180

Installieren und starten Sie eine APK:

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

Untersuchen Sie den Android-Bildschirm:

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

Lesen Sie den Maschinenvertrag vor der Automatisierung:

droidlume schema
droidlume schema device start

Siehe das vollständige Befehlsverzeichnis, den MCP-Leitfaden, die Status- und Sicherheitsregeln und die Fehlerreferenz.

Architektur

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

Die öffentliche CLI und der MCP-Server kommunizieren über Loopback mit der DroidLume-Host-App. Gerätelebenszyklus, App-Installation, Screenshots, Eingaben und Diagnosen laufen weiterhin über denselben RuntimeController, der auch von der nativen macOS-Oberfläche verwendet wird.

Warum DroidLume Agent Control

Generische Android-Automatisierung legt häufig rohe ADB-Seriennummern offen oder hängt von Screenshot-Koordinaten ab. DroidLume bietet stattdessen einen Steuerungsvertrag auf Produktebene:

• Stabile Geräte-UUIDs statt transienter Emulator-Seriennummern;

• Lebenszyklusbewusste Handhabung von Start, Stopp, Neustart, Reparatur und Quick Boot;

• Gestreamter APK-Upload in die DroidLume-Sandbox;

• Strukturierte Befehlsermittlung und strukturierte Fehler;

• Eine gemeinsame Steuerungsebene für die native App, CLI, MCP und Shortcuts.

FAQ

Ist das ein Android-Emulator?

DroidLume ist die Anwendung für virtuelle Android-Geräte. Dieses Repository stellt die npm-CLI/MCP-Implementierung und die Agent Skill bereit, die zu ihrer Automatisierung verwendet werden; es ist keine zweite macOS-Anwendung.

Verwendet es rohes ADB als öffentliche Schnittstelle?

Nein. KI-Clients rufen die versionierte DroidLume-Steuerungs-API auf. Die Host-App besitzt ihren privaten ADB-Namespace und den Lebenszyklus der verwalteten Geräte.

Welche KI-Tools werden unterstützt?

Die Agent Skill folgt dem offenen SKILL.md-Format. Die CLI funktioniert in jeder Shell, und der MCP-Server funktioniert mit MCP-fähigen Clients, einschließlich Codex, Claude Code, Cursor und Gemini-Tooling.

Ist das Tool lokal?

Ja. Der DroidLume-Host-Steuerungsendpunkt lauscht auf 127.0.0.1, und droidlume-mcp verwendet lokalen stdio-Transport.

Links

• Offizielle DroidLume-Website

• Dokumentation zu Agent Control

• npm-Paket

• Support

Lizenz

Die Agent Skill und die Dokumentation in diesem Repository stehen unter der MIT-Lizenz zur Verfügung. DroidLume-Anwendungsbinärdateien und -marken unterliegen weiterhin ihren jeweiligen Produktbedingungen.