Skip to main content
Glama

omp-worker-mcp

비동기 코딩 작업 및 DAG 워크플로를 로컬 Oh My Pi (OMP) CLI 하위 에이전트에 위임하는 지속형 Model Context Protocol (MCP) 서버.

MIT License Node.js MCP Protocol

빠른 시작 • 구성 • 사용 가능한 도구 • 작업 안전 및 소유권 계약 • 업스트림 출처 및 고지 사항


주요 하이라이트

  • ⚡ 비동기 위임 실행: 메인 대화 세션을 차단하지 않고 무거운 코딩, 리팩터링, 탐색 작업을 백그라운드 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_WORKER_OMP_COMMAND

OMP CLI 바이너리의 경로 또는 실행 파일 이름.

omp

OMP_WORKER_OMP_PREFIX_ARGS

OMP CLI 호출에 앞에 추가되는 인수의 JSON 배열.

[]

OMP_WORKER_STATE_DIR

작업 상태, 시도, 로그, 아티팩트를 저장하는 디렉터리.

~/.codex/state/omp-worker

OMP_WORKER_BROWSER_RULES

태스크 프롬프트에 주입되는 선택적 사용자 지정 브라우저 자동화 지침.

(none)

크로스 플랫폼 환경 예시

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

Codex 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 도구

도구

목적

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. 쓰기 vs. 읽기 전용 격리:

    • 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

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers