{"type": "text"}

omp-worker-mcp

English · 简体中文

Deja de gastar tu cuota de los mejores modelos en trabajo mecánico.

Deja que Claude Code, Codex, Grok Build, Kimi Code o cualquier otro cliente MCP delegue búsquedas, limpiezas, trabajos por lotes y análisis amplios del repositorio a los modelos más pequeños que ya configuraste en OMP.

Por qué lo hice

Normalmente tengo varios agentes de codificación abiertos a la vez: Codex en una ventana, Grok Build o Kimi Code en otra, y OMP cerca. Algunos de los planes integrados en OMP me dan mucho tiempo de modelo por el dinero. Son perfectos para análisis de repositorios, revisiones iniciales y trabajos repetitivos que consumen muchos tokens.

Mis planes para las herramientas que uso a diario son más pequeños. Cuando la cuota se agota, lo último que quiero es otro documento de traspaso o una ronda de copiar y pegar indicaciones entre ventanas de terminal. El agente con el que ya estoy hablando debería poder enviar el trabajo y traer el resultado.

Así que construí este servidor MCP. Tu agente principal mantiene el contexto y toma las decisiones. OMP se encarga del trabajo de fondo acotado. Claude Code, Codex, Grok Build, Kimi Code, OpenCode, Cursor y otros clientes MCP pueden compartir los mismos roles y agentes de tarea de OMP.

Related MCP server: todos

Lo que obtiene tu agente

La mayoría de los trabajos solo necesitan dos herramientas:

• run inicia un trabajador de OMP y devuelve un ID de trabajo.

• wait recopila uno o varios resultados.

Tu agente puede iniciar varios trabajos independientes, seguir trabajando y luego recopilar los resultados juntos. status, list, cancel, agents y roles cubren el resto.

Cada trabajador tiene un agent y un role. El agente describe cómo abordar la tarea, como scout o reviewer. El rol elige una de las asignaciones de modelos de tu configuración de OMP, como task, slow o designer. Si omites ambos, el servidor usa task.

Configuración

Necesitas Node.js 22 o superior y un Oh My Pi instalado y autenticado.

git clone https://github.com/elijah7x/omp-worker-mcp.git
cd omp-worker-mcp
node src/server.js --self-check
npm run check

Luego pídele al proyecto que imprima un fragmento de configuración para tu cliente:

node scripts/client-config.js claude
node scripts/client-config.js codex
node scripts/client-config.js opencode
node scripts/client-config.js standard-json

El script imprime la configuración y no toca tus archivos. La configuración del cliente cubre los clientes probados, sus ubicaciones de configuración y el formato stdio genérico. Usa omp como nombre del servidor MCP.

Para probar un envío real después de conectarlo:

npm run check:worker

Ponlo a hacer trabajo útil

Los trabajadores de OMP son más útiles cuando una tarea tiene un límite claro y puede devolver un resultado en lugar de tomar la decisión final. Algunos ejemplos:

• Buscar en un repositorio y explicar cómo funciona un subsistema.

• Revisar un módulo en busca de errores o problemas de seguridad.

• Ejecutar una suite de pruebas, investigar los fallos e informar de la causa probable.

• Comparar varios archivos o redactar una primera implementación.

Inicia los trabajos independientes a la vez. Deja la edición final, el criterio de producto y la respuesta al usuario en el agente principal.

Los clientes con soporte de habilidades o reglas pueden instalar SKILL.md. Otros clientes pueden trabajar a partir de las descripciones de las herramientas MCP.

Una llamada a run tiene este aspecto:

{
  "prompt": "Review the authentication module for concrete security issues. Return findings with file paths and line numbers.",
  "cwd": "/path/to/project",
  "agent": "reviewer",
  "role": "slow"
}

El trabajador se ejecuta mediante el modo de impresión no interactivo de OMP. No se apodera de una ventana TUI de OMP que ya tengas abierta.

Usa tus propios modelos y agentes

El puente no mantiene un segundo registro de modelos. Añade o cambia modelos en OMP, donde ya viven la configuración de tu proveedor y la autenticación.

Por ejemplo, añade roles al mapa modelRoles en forma de bloque en ~/.omp/agent/config.yml:

modelRoles:
  task: your-provider/fast-model
  slow: your-provider/reasoning-model
  designer: your-provider/vision-model

Reinicia el cliente MCP y llama a roles. Los nuevos nombres están listos para usarse como run.role; el servidor no necesita ningún cambio de código.

Los agentes de tarea personalizados de OMP funcionan igual. Añade uno al directorio de agentes de OMP, reinicia el cliente, llama a agents y usa su nombre como run.agent.

Conecta otro cliente MCP

El servidor usa MCP stdio local. En la mayoría de los clientes, el comando es:

node /absolute/path/to/omp-worker-mcp/src/server.js

node scripts/client-config.js standard-json te da un punto de partida. Si un cliente espera un formato de configuración distinto, añade un pequeño renderizador a scripts/client-config.js, un ejemplo limpio en examples/ y una fila en la configuración del cliente. No necesitas tocar el servidor.

Acceso y privacidad

Este proyecto asume una máquina de confianza y un solo usuario. Los trabajadores de OMP se ejecutan sin supervisión con los mismos permisos de archivos y comandos que tu usuario local.

Cada llamada a run debe pasar un cwd absoluto existente, para que un trabajador no pueda colarse en el directorio de lanzamiento del cliente MCP. Los proyectos de tu carpeta de inicio, los volúmenes externos y los worktrees de los clientes funcionan sin configuración adicional. Establece OMP_WORKER_ALLOWED_ROOTS si quieres restringir los trabajos a raíces específicas; es una lista de permitidos opcional, no una zona de pruebas.

Las habilidades y reglas privadas de OMP permanecen desactivadas a menos que una llamada las active. El servidor pasa un pequeño conjunto de variables de entorno a los trabajadores y oculta las asignaciones de modelos y las rutas locales de los agentes de forma predeterminada.

Las indicaciones y los resultados permanecen en ~/.omp/omp-worker-mcp/jobs/. Pueden contener código fuente. Usa un contenedor, una zona de pruebas del sistema operativo o una cuenta restringida si el acceso de usuario local es demasiado amplio para tu proyecto. La configuración del cliente documenta el comportamiento del entorno y las credenciales.

Desarrollo

npm run check

La suite de pruebas cubre el análisis de configuración, las configuraciones de cliente generadas, ambos estilos de enmarcado MCP compatibles, el ciclo de vida de los trabajos y un proceso OMP simulado. npm run check:worker añade un envío OMP en vivo.

La versión actual es compatible con stdio local, trabajos desacoplados, descubrimiento de roles y agentes, cancelación y resultados guardados. La transmisión de tokens, el transporte remoto, el control TUI en vivo y la limpieza automática de trabajos quedan fuera del alcance actual.

Licencia

MIT