omp-worker-mcp
omp-worker-mcp
비동기 코딩 작업 및 DAG 워크플로를 로컬 Oh My Pi (OMP) CLI 하위 에이전트에 위임하는 지속형 Model Context Protocol (MCP) 서버.
빠른 시작 • 구성 • 사용 가능한 도구 • 작업 안전 및 소유권 계약 • 업스트림 출처 및 고지 사항
주요 하이라이트
⚡ 비동기 위임 실행: 메인 대화 세션을 차단하지 않고 무거운 코딩, 리팩터링, 탐색 작업을 백그라운드 OMP 워커 인스턴스에 오프로드합니다.
🔀 위상적 DAG 오케스트레이션: 자동 위상 정렬, 동시성 제어, 의존성 전파를 통해 상호 의존적인 배치 작업을 실행합니다.
🛡️ 작업 공간 경로 격리: 명시적 쓰기 경계를 적용하고 동시 작업 간 파일 수정 충돌을 방지합니다.
🔍 감독형 재개 및 봉투: 중간 로그를 실시간으로 검사하고, 구조화된 JSON 결과 봉투를 추출하며, 재시도 또는 작업 조정을 위한 감독 지침을 제공합니다.
Related MCP server: claude-orchestrator
업스트림 출처 및 고지 사항
외부 업스트림 CLI: 이 프로젝트는 MIT 라이선스로 배포되는 오픈소스 도구인 Oh My Pi (OMP)와 연동합니다.
사용자 사전 요구 사항:
Node.js >= 22.0.0.
사용자는 자신의 로컬 OMP CLI 인스턴스를 설치하고 구성해야 합니다.
사용자는 해당 환경에 적용되는 OMP CLI 라이선스 및 약관을 준수할 책임이 있습니다.
기능
비동기 위임 실행: 메인 대화 세션을 차단하지 않고 독립적인 하위 에이전트 코딩 작업을 실행합니다.
DAG 및 배치 오케스트레이션: 위상적 의존성 정렬, 동시성 제한, 자동 의존성 전파를 통해 상호 의존적인 배치 작업을 실행합니다.
엄격한 작업 안전 및 소유권: 내장된 검증 검사는 여러 동시 작업이 겹치는 파일 경로에 쓰거나 동일한 작업 공간 내에서 충돌하는 것을 방지합니다.
지속적인 감독 및 피드백: 중간 출력을 검사하고, 로그를 스트리밍하고, 구조화된 JSON 봉투를 가져오며, 계속 진행하거나 재시도할 수 있도록 감독 피드백을 제공합니다.
크로스 플랫폼 설계: Windows, macOS, Linux의 로컬 Node.js 환경을 위해 설계되었습니다. 플랫폼에서 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 CLI 바이너리의 경로 또는 실행 파일 이름. |
|
| OMP CLI 호출에 앞에 추가되는 인수의 JSON 배열. |
|
| 작업 상태, 시도, 로그, 아티팩트를 저장하는 디렉터리. |
|
| 태스크 프롬프트에 주입되는 선택적 사용자 지정 브라우저 자동화 지침. | (none) |
크로스 플랫폼 환경 예시
Windows (cmd / PowerShell)
set OMP_WORKER_OMP_COMMAND=omp
set OMP_WORKER_STATE_DIR=C:\Users\YourUser\.codex\state\omp-workermacOS / Linux (bash / zsh)
export OMP_WORKER_OMP_COMMAND=/usr/local/bin/omp
export OMP_WORKER_STATE_DIR=/home/youruser/.codex/state/omp-workerCodex MCP 클라이언트 구성 예시
서버를 Codex MCP 구성에 추가하세요 (예: 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 도구
도구 | 목적 |
| 편의 도구: 단일 작업을 위임하고 한 턴 내에 |
| 코딩 작업을 위한 비동기 백그라운드 워커를 생성하고 즉시 |
| 실행 중인 백그라운드 작업이 끝날 때까지 기다리거나 타임아웃에 도달할 때까지 폴링합니다. |
| 작업의 전체 시도 이력, 로그, 출력, 파싱된 구조화 봉투를 가져옵니다. |
| 실패하거나 차단된 작업에 감독 수정/지침을 제공하여 새 시도를 시작합니다. |
| 실행 중인 작업과 그 하위 프로세스 트리를 정상적으로 종료합니다. |
| 병렬/순차 배치 작업의 의존성 그래프(DAG)를 생성하고 완료를 기다립니다. |
| 비동기 배치 작업 그룹이 진행되거나 완료될 때까지 기다립니다. |
| 배치 그룹 내 실행 중 및 대기 중인 모든 작업을 취소합니다. |
작업 안전 및 소유권 계약
쓰기 vs. 읽기 전용 격리:
write작업은 자신이 소유한 특정 파일 경로를 선언해야 합니다.read_only작업은 작업 공간 수정이 엄격히 금지됩니다.
DAG 중복 검증:
병렬로 실행되는 작업은 겹치는 쓰기 경계를 선언할 수 없습니다.
공유 경로를 수정하는 작업은 명시적인 선형 DAG 의존성(
depends_on)을 선언해야 합니다.
구조화된 검증 계약:
완료된 모든 하위 작업은 구조화된 검증 세부 정보와 업데이트된 아티팩트 설명을 반환해야 합니다.
라이선스
이 프로젝트는 MIT 라이선스로 라이선스가 부여됩니다.
Available Tools
9 toolsomp_cancelStop OMP TaskADestructiveIdempotent
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 GroupADestructiveIdempotent
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 SessionADestructive
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)ADestructive
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 ResultARead-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)ADestructive
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)ADestructive
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 TaskARead-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 GroupARead-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
Scored across 9 tools
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.
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.
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.
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
Related MCP Connectors
- aXDeprecatedio.github.ax-platform
Agent-native collaboration network: orchestrate a team of long-running agents from any MCP client.
Task manager for AI agents. Orchestrate agents to achieve large goals in unified control plane.
AI work orchestration for plans, tasks, teams, and coding-agent dispatch.
Design, build and run teams of AI agents with checked handoffs between them.
Related MCP Servers
- AlicenseAqualityAmaintenanceEnables orchestrating external AI-agent CLIs like Codex to execute project development tasks through an async task system with objective verification and automated failure rework loops.8182 npm11Apache 2.0
- AlicenseAqualityBmaintenanceEnables Cursor's main agent to delegate development tasks to Claude CLI subagents via MCP, supporting synchronous, asynchronous, and parallel task execution with monitoring and control.7ISC
- AlicenseCqualityBmaintenanceEnables multiple CLI-based AI agents to collaborate as a coordinated team through shared task queues, shared memory, and a message bus, with DAG orchestration, rate-limit avoidance, parallel dispatching, and long-task management.633MIT
- FlicenseNot gradedqualityAmaintenanceEnables a primary AI assistant to delegate tasks in parallel to specialized local CLI-based AI sub-agents, share project context, and synthesize their responses through a single MCP interface.-