Orquestador de MCP Server Python

Servidor MCP de flujo de trabajo en 4 fases, verificado por máquina, para asistentes de codificación de IA. Hace cumplir DESIGN → PLAN → EXECUTE → VERIFY → COMPLETE con compuertas de aprobación humana, comprobaciones de integridad de estado y planificación de tareas por DAG.

🚀 Ciclo de vida del flujo de trabajo

[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

🛠️ Referencia de herramientas MCP

📋 Requisitos de entregables por fase

1. Fase DESIGN:

   • Entregable: .orchestrator/design.md

   • Encabezados obligatorios: ## Requirements, ## Architecture, ## Self-Confidence Audit.

   • Compuerta: requiere orchestrate_approve antes de la verificación.

2. Fase PLAN:

   • Entregable: .orchestrator/plan.md

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

   • Especificaciones detalladas: una sección ### <id> para cada tarea.

   • Barrera final: la tarea final DEBE estar asignada a Agent: implementation-reviewer y bloqueada por todas las tareas anteriores.

   • Comando de prueba: debe ser un comando ejecutable válido Test command: <cmd> dentro de ## Verification.

   • Compuerta: requiere orchestrate_approve antes de la verificación.

3. Fase EXECUTE:

   • Regla: todas las tareas de .orchestrator/plan.md deben estar marcadas como completadas con - [x].

   • Regla: los archivos de destino deben existir en el disco y tener un tamaño superior a 0 bytes.

4. Fase VERIFY:

   • Regla: ejecuta el comando de prueba del plan mediante un subproceso de shell (timeout de 120 s). Se supera si el código de salida es 0.

⚡ Inicio rápido

Instalación y ejecución

# 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

Configuración MCP de OpenCode (opencode.json)

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