Skip to main content
Glama
deenesjakoruzh
MoyGulati

claude-operator

by MoyGulati
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

claude-operator

Claude Code 세션을 자율 운영자로 변환하는 TypeScript MCP 서버입니다. 목표를 분해하고, 여러 프로젝트에 걸쳐 작업자 세션을 생성 및 조정하며, 2계층 지속적 메모리를 관리하고, 가드레일을 적용하며, 사후 인간 검토를 통해 학습합니다.

설치

npm install -g claude-operator
claude-operator init
claude-operator start

init은 ~/.claude-operator/ (SQLite DB, 버스 디렉토리, 설정)를 스캐폴딩합니다. start는 stdio에서 MCP 서버를 실행하고 http://localhost:7373에서 대시보드를 실행합니다.

Related MCP server: claude-swarm

Claude Code에 연결

~/.claude/settings.json에 추가하세요:

{
  "mcpServers": {
    "claude-operator": {
      "command": "claude-operator",
      "args": ["start", "--mcp"]
    }
  }
}

또는 로컬 개발 빌드를 가리키세요:

{
  "mcpServers": {
    "claude-operator": {
      "command": "node",
      "args": ["/path/to/claude-operator/packages/server/dist/server.js"]
    }
  }
}

아키텍처

Operator session (Claude Code)
        │  MCP tools (10)
        ▼
┌─────────────────────────────────┐
│  claude-operator MCP server     │
│  ┌──────────┐  ┌─────────────┐ │
│  │  SQLite  │  │  File bus   │ │
│  │  WAL+FTS5│  │  heartbeat  │ │
│  └──────────┘  └─────────────┘ │
│  ┌──────────────────────────┐  │
│  │  Monitor loop (30s poll) │  │
│  └──────────────────────────┘  │
└────────────┬────────────────────┘
             │  spawn / bus read-write
    ┌────────┴────────┐
    ▼                 ▼
Worker A          Worker B
(git worktree)    (git worktree)
operator/w-abc    operator/w-def

2계층 메모리 — 1계층(휘발성, 30일 후 자동 만료) 및 2계층(지속성, 인간 확인 완료). 운영자가 분류를 제안하면 대시보드에서 인간이 확인합니다(pending_classification=TRUE).

파일 버스 — 기본 작업자↔운영자 상태 채널. 작업자는 <bus-dir>/<worker-id>.json에 하트비트를 기록합니다. 모니터 루프는 응답 없는 작업자(2분 이상 하트비트 없음)를 감지하여 실패로 표시합니다.

가드레일 — 도구 호출 전에 적용되는 JSON 규칙입니다. set_guardrail을 통해 설정하고 get_guardrails를 통해 검사합니다.

도구 참조

도구

설명

assign_task

목표, 프로젝트 경로, 우선순위, 제약 조건이 포함된 작업 생성

spawn_worker

격리된 git 작업 트리에서 Claude Code 작업자(이름 지정 또는 헤드리스) 실행

get_worker_status

작업자 상태, 하트비트 경과 시간, 현재 작업 폴링

complete_task

작업 완료 표시, 작업 트리 브랜치 병합, 정리

search_memory

운영자 메모리 전체에 대한 FTS5 전문 검색

update_memory

계층 및 신뢰도와 함께 메모리 항목 작성/업데이트

set_guardrail

가드레일 규칙 추가 또는 업데이트

get_guardrails

활성 가드레일 규칙 나열

inject_instruction

파일 버스를 통해 실행 중인 작업자에게 지침 전송

log_judgment_call

사후 학습을 위해 인간의 판단 기록

대시보드

http://localhost:7373 — 작업 보드, 작업자 상태, 가드레일 편집기, 메모리 브라우저, 판단 기록 로그, SSE 로그 스트림.

CLI

claude-operator init          # scaffold config + DB
claude-operator start         # start MCP server + dashboard
claude-operator status        # print active workers + tasks
claude-operator retro         # open judgment call log

개발

git clone https://github.com/MoyGulati/claude-operator
cd claude-operator
pnpm install
pnpm build
pnpm test        # 39 tests
./verify.sh      # full gate (build + test)

요구 사항: Node 24+, pnpm 10+.

라이선스

MIT

This server cannot be installed

F
license - not found
Not graded
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/MoyGulati/claude-operator'

If you have feedback or need assistance with the MCP directory API, please join our Discord server