Skip to main content
Glama

omp-worker-mcp

Servidor durable del Model Context Protocol (MCP) para delegar tareas de codificación asíncronas y flujos de trabajo DAG a subagentes CLI locales de Oh My Pi (OMP).

MIT License Node.js MCP Protocol

Inicio rápido • Configuración • Herramientas disponibles • Contrato de seguridad • Atribución ascendente


Aspectos destacados

  • ⚡ Ejecución delegada asíncrona: Descargue tareas pesadas de codificación, refactorización y exploración a instancias de trabajadores OMP en segundo plano sin bloquear su sesión de conversación principal.

  • 🔀 Orquestación DAG topológica: Ejecute tareas por lotes interdependientes con ordenamiento topológico automático, control de concurrencia y propagación de dependencias.

  • 🛡️ Aislamiento de rutas de espacio de trabajo: Aplique límites explícitos de rutas de escritura y evite modificaciones superpuestas de archivos entre tareas concurrentes.

  • 🔍 Reanudación supervisada y sobres: Inspeccione registros provisionales en tiempo real, extraiga sobres de resultados JSON estructurados y proporcione orientación de supervisión para reintentar o ajustar tareas.


Related MCP server: claude-orchestrator

Atribución ascendente y descargo de responsabilidad

  • CLI ascendente externo: Este proyecto se interconecta con Oh My Pi (OMP), una herramienta de código abierto publicada bajo la Licencia MIT.

  • Requisitos previos del usuario:

    • Node.js >= 22.0.0.

    • Los usuarios deben instalar y configurar su propia instancia local de la CLI de OMP.

    • Los usuarios son responsables de cumplir con la licencia y los términos de la CLI de OMP aplicables a su entorno.


Características

  • Ejecución delegada asíncrona: Inicie tareas de codificación de subagentes independientes sin bloquear la sesión de conversación principal.

  • Orquestación DAG y por lotes: Ejecute tareas por lotes interdependientes con ordenamiento de dependencias topológico, límites de concurrencia y propagación automática de dependencias.

  • Seguridad y propiedad estrictas de tareas: Las comprobaciones de validación integradas evitan que múltiples tareas concurrentes escriban en rutas de archivo superpuestas o colisionen dentro del mismo espacio de trabajo.

  • Supervisión y retroalimentación continuas: Inspeccione la salida provisional, transmita registros, recupere sobres JSON estructurados y proporcione retroalimentación de supervisión para continuar o reintentar intentos.

  • Diseño multiplataforma: Diseñado para entornos Node.js locales en Windows, macOS y Linux; valide la disponibilidad de la CLI de OMP en su plataforma.


Instalación e inicio rápido

# 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

Configuración

La configuración se gestiona mediante variables de entorno (o se configura directamente en su cliente MCP).

Variable

Descripción

Por defecto

OMP_WORKER_OMP_COMMAND

Ruta o nombre del ejecutable para el binario de la CLI de OMP.

omp

OMP_WORKER_OMP_PREFIX_ARGS

Matriz JSON de argumentos antepuestos a las invocaciones de la CLI de OMP.

[]

OMP_WORKER_STATE_DIR

Directorio para almacenar estados de trabajos, intentos, registros y artefactos.

~/.codex/state/omp-worker

OMP_WORKER_BROWSER_RULES

Instrucciones personalizadas opcionales de automatización del navegador inyectadas en los avisos de tareas.

(ninguno)

Ejemplos de entornos multiplataforma

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

Ejemplo de configuración del cliente MCP de Codex

Agregue el servidor a su configuración de MCP de Codex (p. ej., en config.toml):

Ejemplo de 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"

Ejemplo de 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"

Herramientas MCP disponibles

Tool

Propósito

omp_run_compact

Herramienta de conveniencia: delega una única tarea y espera hasta wait_seconds para completarse en un turno.

omp_delegate

Genera un trabajador en segundo plano asíncrono para una tarea de codificación y devuelve inmediatamente un job_id.

omp_wait

Espera a que un trabajo en segundo plano termine o sondea hasta que se alcance un tiempo de espera.

omp_result

Obtiene el historial completo de intentos, registros, salidas y sobres estructurados analizados de un trabajo.

omp_continue

Introduce corrección/orientación de supervisión en un trabajo fallido o bloqueado para un nuevo intento.

omp_cancel

Termina de forma controlada un trabajo en ejecución y su árbol de procesos hijo.

omp_run_batch_compact

Genera un grafo de dependencias (DAG) de tareas por lotes paralelas/secuenciales y espera su finalización.

omp_wait_group

Espera a que un grupo de tareas por lotes asíncronas progrese o se complete.

omp_cancel_group

Cancela todas las tareas en ejecución y en cola dentro de un grupo por lotes.


Contrato de seguridad y propiedad de tareas

  1. Aislamiento de escritura vs. solo lectura:

    • Las tareas write deben declarar las rutas de archivo específicas que poseen.

    • Las tareas read_only están estrictamente restringidas de la modificación del espacio de trabajo.

  2. Verificación de superposición DAG:

    • Las tareas que se ejecutan en paralelo no pueden declarar límites de escritura superpuestos.

    • Las tareas que modifican rutas compartidas deben declarar dependencias DAG lineales explícitas (depends_on).

  3. Contrato de verificación estructurada:

    • Se espera que cada subtarea completada devuelva detalles de verificación estructurados y descripciones de artefactos actualizadas.


Licencia

Este proyecto está bajo la Licencia 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