Orchestrator Python MCP Server

Maschinenverifizierter 4-Phasen-Workflow-MCP-Server für KI-Codierungsassistenten. Erzwingt den Ablauf DESIGN → PLAN → EXECUTE → VERIFY → COMPLETE mit menschlichen Freigabegates, Zustandsintegritätsprüfungen und DAG-Aufgabenplanung.

🚀 Workflow-Lebenszyklus

[Start] ──> orchestrate_init(task="...")
                │
                ▼ (DESIGN Phase)
        Write `.orchestrator/design.md`
                │
                ▼
        orchestrate_approve()  ──>  orchestrate_verify()
                                        │
                ┌───────────────────────┘
                ▼ (PLAN Phase)
        Write `.orchestrator/plan.md`
                │
                ▼
        orchestrate_approve()  ──>  orchestrate_verify()
                                        │
                ┌───────────────────────┘
                ▼ (EXECUTE Phase)
        orchestrate_get_dag_batches()
        Subagents implement tasks & mark [x]
                │
                ▼
        orchestrate_verify()
                │
                ▼ (VERIFY Phase)
        orchestrate_verify() (runs automated test command)
                │
                ▼ (COMPLETE Phase)
        orchestrate_archive() ──> [Done]

Related MCP server: Overture

🛠️ MCP-Tools-Referenz

📋 Deliverable-Anforderungen pro Phase

1. DESIGN-Phase:

   • Deliverable: .orchestrator/design.md

   • Erforderliche Überschriften: ## Requirements, ## Architecture, ## Self-Confidence Audit.

   • Gate: Erfordert orchestrate_approve vor der Verifikation.

2. PLAN-Phase:

   • Deliverable: .orchestrator/plan.md

   • Aufgabenschema: - [ ] **<id>**: <desc> (Agent: <role>, Target: <file>, blocked_by: [<deps>])

   • Detaillierte Spezifikationen: ### <id>-Abschnitt für jede Aufgabe.

   • Letzte Barriere: Die letzte Aufgabe MUSS an Agent: implementation-reviewer zugewiesen sein und von allen vorherigen Aufgaben blockiert werden.

   • Testbefehl: Gültiger ausführbarer Befehl Test command: <cmd> unter ## Verification.

   • Gate: Erfordert orchestrate_approve vor der Verifikation.

3. EXECUTE-Phase:

   • Regel: Alle Aufgaben in .orchestrator/plan.md sind als erledigt markiert - [x].

   • Regel: Zieldateien müssen auf der Festplatte vorhanden sein und eine Größe größer als 0 Bytes haben.

4. VERIFY-Phase:

   • Regel: Führt den Testbefehl des Plans über einen Shell-Unterprozess aus (Timeout: 120s). Bestanden, wenn der Exit-Code 0 ist.

⚡ Schnellstart

Installation & Start

# Sync environment
uv sync

# Run tests (Unit + 18 BDD Scenarios)
uv run pytest

# Start MCP server (stdio transport)
uv run python -m orchestrator_mcp.server

OpenCode-MCP-Konfiguration (opencode.json)

{
  "mcpServers": {
    "orchestrator": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/orchestrate", "python", "-m", "orchestrator_mcp.server"]
    }
  }
}