omp-worker-mcp

Robuster Model Context Protocol (MCP)-Server zur Delegierung asynchroner Codierungsaufgaben und DAG-Workflows an lokale Oh My Pi (OMP)-CLI-Subagenten.

Schnellstart • Konfiguration • Verfügbare Tools • Sicherheitsvertrag • Upstream-Attribution

Wichtigste Highlights

• ⚡ Asynchrone delegierte Ausführung: Lagern Sie schwere Codierungs-, Refactoring- und Erkundungsaufgaben an Hintergrund-OMP-Worker-Instanzen aus, ohne Ihre Hauptkonversationssitzung zu blockieren.

• 🔀 Topologische DAG-Orchestrierung: Führen Sie voneinander abhängige Batch-Aufgaben mit automatischer topologischer Sortierung, Parallelitätssteuerung und Abhängigkeitsweitergabe aus.

• 🛡️ Arbeitsbereich-Pfadisolation: Erzwingen Sie explizite Schreibpfadgrenzen und verhindern Sie überlappende Dateiänderungen bei gleichzeitigen Aufgaben.

• 🔍 Überwachte Wiederaufnahme & Envelopes: Untersuchen Sie Zwischenlogs in Echtzeit, extrahieren Sie strukturierte JSON-Ergebnis-Envelopes und geben Sie überwachende Anweisungen, um Aufgaben zu wiederholen oder anzupassen.

Upstream-Attribution & Haftungsausschluss

• Externe Upstream-CLI: Dieses Projekt interagiert mit Oh My Pi (OMP), einem Open-Source-Tool, das unter der MIT-Lizenz veröffentlicht wurde.

• Voraussetzungen für Benutzer:

  • Node.js >= 22.0.0.

  • Benutzer müssen eine eigene lokale Instanz der OMP-CLI installieren und konfigurieren.

  • Benutzer sind dafür verantwortlich, die OMP-CLI-Lizenz und die für ihre Umgebung geltenden Bedingungen einzuhalten.

Funktionen

• Asynchrone delegierte Ausführung: Starten Sie unabhängige Sub-Agent-Codierungsaufgaben, ohne die Hauptkonversationssitzung zu blockieren.

• DAG- & Batch-Orchestrierung: Führen Sie voneinander abhängige Batch-Aufgaben mit topologischer Abhängigkeitssortierung, Parallelitätslimits und automatischer Abhängigkeitsweitergabe aus.

• Strenge Aufgabensicherheit & Pfadbesitz: Integrierte Validierungsprüfungen verhindern, dass mehrere gleichzeitige Aufgaben in überlappende Dateipfade schreiben oder im selben Arbeitsbereich kollidieren.

• Kontinuierliche Überwachung & Feedback: Untersuchen Sie Zwischenausgaben, streamen Sie Logs, rufen Sie strukturierte JSON-Envelopes ab und geben Sie überwachendes Feedback, um Versuche fortzusetzen oder zu wiederholen.

• Plattformübergreifendes Design: Entwickelt für lokale Node.js-Umgebungen unter Windows, macOS und Linux; validieren Sie die Verfügbarkeit der OMP-CLI auf Ihrer Plattform.

Installation & Schnellstart

# 1. Clone the repository
git clone https://github.com/divenire990/omp-worker-mcp.git
cd omp-worker-mcp

# 2. Install dependencies
npm ci

# 3. Build TypeScript to dist/
npm run build

# 4. Run test suite
npm test

Konfiguration

Die Konfiguration erfolgt über Umgebungsvariablen (oder direkt in Ihrem MCP-Client).

Plattformübergreifende Umgebungsbeispiele

Windows (cmd / PowerShell)

set OMP_WORKER_OMP_COMMAND=omp
set OMP_WORKER_STATE_DIR=C:\Users\YourUser\.codex\state\omp-worker

macOS / Linux (bash / zsh)

export OMP_WORKER_OMP_COMMAND=/usr/local/bin/omp
export OMP_WORKER_STATE_DIR=/home/youruser/.codex/state/omp-worker

Beispiel für die Codex-MCP-Client-Konfiguration

Fügen Sie den Server zu Ihrer Codex-MCP-Konfiguration hinzu (z. B. in config.toml):

Windows-Beispiel

[mcp_servers.omp-worker]
command = "node"
args = ["C:/path/to/omp-worker-mcp/dist/index.js"]

[mcp_servers.omp-worker.env]
OMP_WORKER_OMP_COMMAND = "omp"
OMP_WORKER_STATE_DIR = "C:/Users/YourUser/.codex/state/omp-worker"

macOS-/Linux-Beispiel

[mcp_servers.omp-worker]
command = "node"
args = ["/path/to/omp-worker-mcp/dist/index.js"]

[mcp_servers.omp-worker.env]
OMP_WORKER_OMP_COMMAND = "/usr/local/bin/omp"
OMP_WORKER_STATE_DIR = "/home/youruser/.codex/state/omp-worker"

Verfügbare MCP-Tools

Vertrag zu Aufgabensicherheit & Pfadbesitz

1. Schreib- vs. Nur-Lese-Isolation:

   • write-Aufgaben müssen die spezifischen Dateipfade angeben, die sie besitzen.

   • read_only-Aufgaben sind strikt von Änderungen am Arbeitsbereich ausgeschlossen.

2. DAG-Überlappungsprüfung:

   • Parallel laufende Aufgaben dürfen keine überlappenden Schreibgrenzen angeben.

   • Aufgaben, die gemeinsame Pfade ändern, müssen explizite lineare DAG-Abhängigkeiten (depends_on) angeben.

3. Vertrag zur strukturierten Verifizierung:

   • Von jeder abgeschlossenen Teilaufgabe wird erwartet, dass sie strukturierte Verifizierungsdetails und aktualisierte Artefaktbeschreibungen zurückgibt.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.