Orchestrator Python MCP Server

MCP-сервер с машинно-верифицируемым 4-фазным рабочим процессом для ИИ-ассистентов программирования. Он обеспечивает соблюдение DESIGN → PLAN → EXECUTE → VERIFY → COMPLETE с шлюзами ручного утверждения, проверками целостности состояния и DAG-планированием задач.

🚀 Жизненный цикл рабочего процесса

[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-инструментов

📋 Требования к артефактам по фазам

1. Фаза DESIGN:

   • Артефакт: .orchestrator/design.md

   • Обязательные заголовки: ## Requirements, ## Architecture, ## Self-Confidence Audit.

   • Шлюз: перед верификацией требуется orchestrate_approve.

2. Фаза PLAN:

   • Артефакт: .orchestrator/plan.md

   • Схема задач: - [ ] [id]**: <desc> (Agent: <role>, Target: <file>, blocked_by: [<deps>])

   • Детальные спецификации: раздел ### <id> для каждой задачи.

   • Финальный барьер: финальная задача должна быть назначена Agent: implementation-reviewer и должна быть заблокирована всеми предыдущими задачами.

   • Тестовая команда: валидная исполняемая команда Test command: <cmd> в разделе ## Verification.

   • Шлюз: перед верификацией требуется orchestrate_approve.

3. Фаза EXECUTE:

   • Правило: все задачи в .orchestrator/plan.md должны быть отмечены галочками: - [x].

   • Правило: целевые файлы должны слушать на диске и иметь размер больше 0 байт.

4. Фаза VERIFY:

   • Правило: запускает тестовую команду плана через подходящий подпроцесс оболочки (таймаут 120 с). Считается успешной, если код возврата равен 0.

⚡ Быстрый старт

Установка и запуск

# 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 (opencode.json)

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