Skip to main content
Glama

omp-worker-mcp

Надёжный сервер Model Context Protocol (MCP) для делегирования асинхронных задач программирования и DAG-рабочих процессов локальным субагентам CLI Oh My Pi (OMP).

MIT License Node.js MCP Protocol

Быстрый старт • Конфигурация • Доступные инструменты • Контракт безопасности • Атрибуция вышестоящего проекта


Ключевые особенности

  • ⚡ Асинхронное делегированное выполнение: Выгружайте тяжёлые задачи программирования, рефакторинга и исследования в фоновые рабочие экземпляры OMP, не блокируя основной диалог.

  • 🔀 Топологическая оркестрация DAG: Выполняйте взаимозависимые пакетные задачи с автоматической топологической сортировкой, контролем параллелизма и распространением зависимостей.

  • 🛡️ Изоляция путей рабочей области: Обеспечивайте явные границы путей записи и предотвращайте перекрывающиеся изменения файлов в параллельных задачах.

  • 🔍 Контролируемое возобновление и конверты: Просматривайте промежуточные журналы в реальном времени, извлекайте структурированные JSON-конверты результатов и предоставляйте контролирующие указания для повторных попыток или корректировки задач.


Related MCP server: claude-orchestrator

Атрибуция вышестоящего проекта и отказ от ответственности

  • Внешний вышестоящий CLI: Этот проект взаимодействует с Oh My Pi (OMP), инструментом с открытым исходным кодом, выпущенным под лицензией MIT.

  • Требования к пользователю:

    • Node.js >= 22.0.0.

    • Пользователи должны установить и настроить собственный локальный экземпляр OMP CLI.

    • Пользователи несут ответственность за соблюдение лицензии и условий OMP CLI, применимых к их среде.


Возможности

  • Асинхронное делегированное выполнение: Запускайте независимые задачи программирования субагентов, не блокируя основной диалоговый сеанс.

  • Оркестрация DAG и пакетов: Выполняйте взаимозависимые пакетные задачи с топологической сортировкой зависимостей, ограничениями параллелизма и автоматическим распространением зависимостей.

  • Строгая безопасность и владение задачами: Встроенные проверки предотвращают запись нескольких параллельных задач в перекрывающиеся пути файлов или конфликты в одной рабочей области.

  • Непрерывное наблюдение и обратная связь: Просматривайте промежуточные результаты, потоковые журналы, извлекайте структурированные JSON-конверты и предоставляйте контролирующую обратную связь для продолжения или повторных попыток.

  • Кроссплатформенный дизайн: Предназначен для локальных сред Node.js на Windows, macOS и Linux; проверьте доступность OMP CLI на вашей платформе.


Установка и быстрый старт

# 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

Конфигурация

Конфигурация управляется через переменные среды (или настраивается непосредственно в вашем MCP-клиенте).

Переменная

Описание

По умолчанию

OMP_WORKER_OMP_COMMAND

Путь или имя исполняемого файла OMP CLI.

omp

OMP_WORKER_OMP_PREFIX_ARGS

JSON-массив аргументов, добавляемых перед вызовами OMP CLI.

[]

OMP_WORKER_STATE_DIR

Каталог для хранения состояний заданий, попыток, журналов и артефактов.

~/.codex/state/omp-worker

OMP_WORKER_BROWSER_RULES

Необязательные пользовательские инструкции по автоматизации браузера, внедряемые в подсказки задач.

(нет)

Примеры для кроссплатформенных сред

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

Пример конфигурации MCP-клиента Codex

Добавьте сервер в конфигурацию MCP Codex (например, в config.toml):

Пример для Windows

[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

[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"

Доступные MCP-инструменты

Инструмент

Назначение

omp_run_compact

Удобный инструмент: делегирует одну задачу и ожидает до wait_seconds завершения за один ход.

omp_delegate

Запускает асинхронного фонового рабочего для задачи программирования и немедленно возвращает job_id.

omp_wait

Ожидает завершения выполняющейся фоновой задачи или опрашивает до истечения времени ожидания.

omp_result

Получает полную историю попыток, журналы, выходные данные и проанализированные структурированные конверты для задания.

omp_continue

Передаёт контролирующие исправления/указания в неудачное или заблокированное задание для новой попытки.

omp_cancel

Корректно завершает выполняющееся задание и его дерево дочерних процессов.

omp_run_batch_compact

Запускает граф зависимостей (DAG) параллельных/последовательных пакетных задач и ожидает завершения.

omp_wait_group

Ожидает выполнения или завершения асинхронной группы пакетных задач.

omp_cancel_group

Отменяет все выполняющиеся и поставленные в очередь задачи в пакетной группе.


Контракт безопасности и владения задачами

  1. Изоляция записи и режима только для чтения:

    • Задачи write должны указывать конкретные пути файлов, которыми они владеют.

    • Задачи read_only строго ограничены в изменении рабочей области.

  2. Проверка перекрытий DAG:

    • Параллельные задачи не могут объявлять перекрывающиеся границы записи.

    • Задачи, изменяющие общие пути, должны объявлять явные линейные зависимости DAG (depends_on).

  3. Структурированный контракт проверки:

    • Каждая завершённая подзадача должна возвращать структурированные детали проверки и обновлённые описания артефактов.


Лицензия

Этот проект распространяется по лицензии MIT.

Available Tools

9 tools
omp_cancelStop OMP TaskA
DestructiveIdempotent

Request immediate cancellation of one exact delegated OMP job. The detached runner owns the OMP child PID and terminates that process tree safely. Call this immediately when the user asks to stop; do not inspect PIDs or manually kill processes first.

Inputs: job_id (required), reason. Returns: error, job_id, status, attempt, +7 more

omp_cancel_groupCancel Batch Task GroupA
DestructiveIdempotent

Request immediate cancellation of a running batch task group and its child tasks. Writes a cancellation request that the detached group coordinator handles safely. Call this immediately when the user asks to stop a batch.

Inputs: group_id (required), reason. Returns: tasks, status, summary, group_id, +6 more

omp_continueSend Supervisory Feedback to Same OMP SessionA
Destructive

Resume the same OMP session with targeted supervisory feedback to correct specific acceptance defects without starting a fresh task from scratch. Bounded to remaining attempts within max_attempts.

Inputs: job_id (required), feedback (required), timeout_minutes. Returns: error, job_id, status, attempt, +7 more

omp_delegateDelegate Complete Task to OMP (Low-level)A
Destructive

Low-level background delegation entrypoint. Transfers ownership of an execution task to OMP and returns immediately with job_id. Prefer omp_run_compact for standard workflows to avoid separate delegate/wait round trips.

Inputs: cwd (required), goal (required), acceptance, max_attempts, +2 more. Returns: error, job_id, status, attempt, +7 more

omp_resultInspect Complete OMP Task ResultA
Read-onlyIdempotent

Retrieve full details of a terminal OMP job, including finalResponse and attempt logs. Call this only when minimal acceptance check fails, high-risk operations occurred, or the user explicitly asks for full inspection; do not call this after every successful compact run.

Inputs: job_id (required). Returns: cwd, goal, error, job_id, +11 more

omp_run_batch_compactRun Batch OMP Tasks with DAG and Compact Aggregated Result (Preferred for Multi-task)A
Destructive

Submits a decomposed group of OMP tasks to execute concurrently in the server-side bounded rolling pool (max_parallel 1-10) using a detached group runner. Enforces dependency DAG and write-ownership safety, waits up to wait_seconds (0-240, default 60s) for batch completion, and returns stable compact aggregated results. If still running when deadline elapses, returns group_id and minimal progress counts for subsequent omp_wait_group.

Inputs: cwd (required), tasks (required), max_parallel, wait_seconds, +4 more. Returns: tasks, status, summary, group_id, +6 more

omp_run_compactRun OMP Task with Compact Result (Preferred for Single Task)A
Destructive

Preferred entrypoint for single substantive execution tasks. Creates a delegated OMP task, launches the detached runner, and waits up to wait_seconds (default 60s) for completion in a single MCP call. If finished, returns a compact summary, artifacts, verification, and details_path without dumping the full final response. If still running at the deadline, returns job_id and status running for subsequent omp_wait.

Inputs: cwd (required), goal (required), acceptance, max_attempts, +3 more. Returns: error, job_id, status, attempt, +7 more

omp_waitWait for OMP TaskA
Read-onlyIdempotent

Wait for an existing OMP job to reach a terminal status, polling up to wait_seconds (default 30s, max 60s). Returns the current status and summary once terminal or when the wait deadline elapses. Avoid polling in a tight loop.

Inputs: job_id (required), wait_seconds. Returns: error, job_id, status, attempt, +7 more

omp_wait_groupWait for Batch Task GroupA
Read-onlyIdempotent

Wait for an existing OMP task group to reach a terminal status, polling up to wait_seconds (0-240, default 60s). If completed, returns full aggregated compact results in original input order. If still running when deadline elapses, returns minimal progress counts without leaking task summaries.

Inputs: group_id (required), wait_seconds. Returns: tasks, status, summary, group_id, +6 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: batch vs single, delegate vs wait vs cancel vs result retrieval vs continue. No two tools overlap in function—omp_run_compact and omp_delegate differ by synchronous vs asynchronous, and omp_wait_group vs omp_wait serve batch vs single jobs.

    Naming Consistency5/5

    All tools follow a consistent `omp_<verb>[_<noun>]` pattern where the verb describes the action (run, wait, cancel, result, continue) and optional noun specifies the target (batch, group, compact). Perfectly predictable and uniform.

    Tool Count5/5

    9 tools precisely cover the lifecycle of both single and batch task execution: submission, waiting, cancellation, result retrieval, and continuation. No tool is superfluous, and the count is tight for the complexity of the domain.

    Completeness5/5

    The tool surface covers every stage of task management: submission (run/delegate), monitoring (wait), cancellation (cancel), post-hoc inspection (result), and iterative correction (continue). No obvious gaps—both single and batch workflows are fully supported.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers