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).

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.

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).

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

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.