omp-worker-mcp

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

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

주요 하이라이트

• ⚡ 비동기 위임 실행: 메인 대화 세션을 차단하지 않고 무거운 코딩, 리팩터링, 탐색 작업을 백그라운드 OMP 워커 인스턴스에 오프로드합니다.

• 🔀 위상적 DAG 오케스트레이션: 자동 위상 정렬, 동시성 제어, 의존성 전파를 통해 상호 의존적인 배치 작업을 실행합니다.

• 🛡️ 작업 공간 경로 격리: 명시적 쓰기 경계를 적용하고 동시 작업 간 파일 수정 충돌을 방지합니다.

• 🔍 감독형 재개 및 봉투: 중간 로그를 실시간으로 검사하고, 구조화된 JSON 결과 봉투를 추출하며, 재시도 또는 작업 조정을 위한 감독 지침을 제공합니다.

업스트림 출처 및 고지 사항

• 외부 업스트림 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 클라이언트에서 직접)로 관리됩니다.

크로스 플랫폼 환경 예시

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

작업 안전 및 소유권 계약

1. 쓰기 vs. 읽기 전용 격리:

   • write 작업은 자신이 소유한 특정 파일 경로를 선언해야 합니다.

   • read_only 작업은 작업 공간 수정이 엄격히 금지됩니다.

2. DAG 중복 검증:

   • 병렬로 실행되는 작업은 겹치는 쓰기 경계를 선언할 수 없습니다.

   • 공유 경로를 수정하는 작업은 명시적인 선형 DAG 의존성(depends_on)을 선언해야 합니다.

3. 구조화된 검증 계약:

   • 완료된 모든 하위 작업은 구조화된 검증 세부 정보와 업데이트된 아티팩트 설명을 반환해야 합니다.

라이선스

이 프로젝트는 MIT 라이선스로 라이선스가 부여됩니다.