omp-worker-mcp

English · 简体中文

고급 모델 할당량을 단순 작업에 낭비하지 마세요.

Claude Code, Codex, Grok Build, Kimi Code 또는 다른 어떤 MCP 클라이언트든 OMP에 이미 구성해 둔 소형 모델에 검색, 정리, 배치 작업, 광범위한 저장소 스캔을 넘겨주세요.

만든 이유

저는 보통 여러 코딩 에이전트를 동시에 엽니다. 한 창에는 Codex, 다른 창에는 Grok Build나 Kimi Code, 그리고 가까이에는 OMP를 띄워 둡니다. OMP에 연결된 일부 요금제는 가격 대비 충분한 모델 사용 시간을 제공합니다. 토큰을 많이 소모하는 저장소 스캔, 1차 리뷰, 반복 작업에 완벽하죠.

매일 사용하는 도구들의 요금제는 더 작습니다. 할당량이 빠듯해지면 가장 원치 않는 것은 또 다른 인수인계 문서를 작성하거나 터미널 창 사이에서 프롬프트를 복사 붙여넣기하는 것입니다. 이미 대화 중인 에이전트가 작업을 보내고 결과를 가져올 수 있어야 합니다.

그래서 이 MCP 서버를 만들었습니다. 주 에이전트는 컨텍스트를 유지하고 결정을 내립니다. OMP는 범위가 제한된 백그라운드 작업을 처리합니다. Claude Code, Codex, Grok Build, Kimi Code, OpenCode, Cursor 및 기타 MCP 클라이언트는 모두 동일한 OMP 역할과 태스크 에이전트를 공유할 수 있습니다.

Related MCP server: todos

에이전트가 얻는 기능

대부분의 작업에는 도구 두 가지만 있으면 됩니다:

• run은 OMP 워커를 시작하고 작업 ID를 반환합니다.

• wait는 하나 또는 여러 결과를 수집합니다.

에이전트는 독립적인 여러 작업을 시작하고, 계속 작업하다가 결과를 함께 수집할 수 있습니다. status, list, cancel, agents, roles가 나머지를 담당합니다.

각 워커에는 agent와 role이 있습니다. agent는 scout이나 reviewer 같은 작업 접근 방식을 설명합니다. role은 OMP 설정의 모델 매핑 중 하나(예: task, slow, designer)를 선택합니다. 둘 다 생략하면 서버는 task를 사용합니다.

설정하기

Node.js 22 이상과 설치되고 인증된 Oh My Pi가 필요합니다.

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

그런 다음 프로젝트에 클라이언트용 구성 스니펫을 출력하도록 요청하세요:

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

스크립트가 설정을 출력하고 파일은 건드리지 않습니다. 클라이언트 설정은 테스트된 클라이언트, 구성 파일 위치, 일반적인 stdio 형식을 다룹니다. MCP 서버 이름으로 omp를 사용하세요.

연결 후 실제 디스패치를 테스트하려면:

npm run check:worker

유용한 작업을 맡기세요

OMP 워커는 작업에 명확한 경계가 있고 최종 결정 대신 결과를 반환할 수 있을 때 가장 유용합니다. 몇 가지 예:

• 저장소를 검색하고 특정 하위 시스템이 어떻게 동작하는지 설명합니다.

• 버그나 보안 문제가 있는지 모듈을 검토합니다.

• 테스트 스위트를 실행하고, 실패를 조사하고, 가능한 원인을 보고합니다.

• 여러 파일을 비교하거나 초안 수준의 1차 구현을 작성합니다.

독립적인 작업을 함께 시작하세요. 최종 편집, 제품 판단, 사용자에 대한 답변은 상위 에이전트에 남겨 두세요.

스킬이나 규칙 지원이 있는 클라이언트는 SKILL.md를 설치할 수 있습니다. 다른 클라이언트는 MCP 도구 설명을 사용할 수 있습니다.

run 호출은 다음과 같습니다:

{
  "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"
}

워커는 OMP의 비대화형 print 모드를 통해 실행됩니다. 이미 열려 있는 OMP TUI 창을 가로채지 않습니다.

자신의 모델과 에이전트 사용하기

브리지는 별도의 모델 레지스트리를 유지하지 않습니다. 공급자 설정과 인증이 이미 있는 OMP에서 모델을 추가하거나 변경하세요.

예를 들어 ~/.omp/agent/config.yml의 블록 형식 modelRoles 맵에 역할을 추가하세요:

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

MCP 클라이언트를 재시작하고 roles를 호출하세요. 새 이름은 run.role로 바로 사용할 수 있으며 서버 코드 변경은 필요 없습니다.

커스텀 OMP 태스크 에이전트도 동일한 방식으로 작동합니다. OMP의 에이전트 디렉토리에 추가하고, 클라이언트를 재시작한 후 agents를 호출하고 그 이름을 run.agent로 사용하세요.

다른 MCP 클라이언트 연결하기

서버는 로컬 stdio MCP를 사용합니다. 대부분의 클라이언트에서 명령어는 다음과 같습니다:

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

node scripts/client-config.js standard-json은 시작점을 제공합니다. 클라이언트가 다른 구성 형식을 기대하는 경우 scripts/client-config.js에 작은 렌더러를 추가하고, examples/ 아래에 깔끔한 예시를, Client setup에 행을 추가하세요. 서버는 건드릴 필요가 없습니다.

접근 및 개인정보

이 프로젝트는 신뢰할 수 있는 단일 사용자 머신을 가정합니다. OMP 워커는 로컬 사용자와 동일한 파일 및 명령 권한으로 무인 실행됩니다.

모든 run 호출은 기존 절대 경로 cwd를 전달해야 하므로 워커가 MCP 클라이언트의 실행 디렉터리로 흘러들어갈 수 없습니다. 홈 폴더 아래의 프로젝트, 외부 볼륨, 클라이언트 worktree 모두 추가 설정 없이 작동합니다. 작업을 특정 루트로 제한하려면 OMP_WORKER_ALLOWED_ROOTS를 설정하세요. 이는 선택적 허용 목록이지 샌드박스가 아닙니다.

비공개 OMP 스킬과 규칙은 호출에서 활성화하지 않는 한 꺼져 있습니다. 서버는 소수의 환경 변수만 워커에 전달하며 모델 매핑과 로컬 에이전트 경로는 기본적으로 숨깁니다.

프롬프트와 결과는 ~/.omp/omp-worker-mcp/jobs/ 아래에 남습니다. 여기에는 소스 코드가 포함될 수 있습니다. 프로젝트에서 로컬 사용자 권한이 우려된다면 컨테이너, OS 샌드박스 또는 제한된 계정을 사용하세요. 클라이언트 설정에서 환경 및 자격 증명 동작을 설명합니다.

개발

npm run check

현재 릴리스는 설정 파싱, 생성된 클라이언트 설정, 지원되는 두 MCP 프레이밍 스타일, 작업 수명 주기, 모의 OMP 프로세스를 지원합니다. npm run check는 라이브 OMP 디스패치를 추가합니다.

현재 릴리스는 로컬 stdio 전송, 분리된 작업, 역할 및 에이전트 발견, 취소, 저장된 결과를 지원합니다. 원격 전송, 라이브 TUI 제어, 작업 자동 정리는 향후 범위에 포함되지 않습니다.

라이선스

MIT