claude-operator

Servidor MCP en TypeScript que convierte cualquier sesión de Claude Code en un operador autónomo: descompone objetivos, genera y coordina sesiones de trabajo en múltiples proyectos, gestiona memoria persistente de dos niveles, aplica salvaguardas y aprende de la revisión humana retrospectiva.

Instalación

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

init crea la estructura ~/.claude-operator/ (base de datos SQLite, directorio de bus, configuración). start inicia el servidor MCP en stdio + panel de control en http://localhost:7373.

Related MCP server: claude-swarm

Integración con Claude Code

Añade esto a tu ~/.claude/settings.json:

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

O apunta a la compilación de desarrollo local:

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

Arquitectura

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

Memoria de dos niveles — nivel 1 (volátil, caducidad automática a 30 días) y nivel 2 (duradero, confirmado por humanos). El operador propone la clasificación; el humano confirma en el panel de control (pending_classification=TRUE).

Bus de archivos — canal de estado principal entre trabajador y operador. Los trabajadores escriben latidos (heartbeats) en <bus-dir>/<worker-id>.json; el bucle de monitorización detecta trabajadores inactivos (sin latido >2 min) y los marca como fallidos.

Salvaguardas — reglas JSON aplicadas antes de cualquier llamada a herramienta. Se establecen mediante set_guardrail y se inspeccionan mediante get_guardrails.

Referencia de herramientas

Panel de control

http://localhost:7373 — tablero de tareas, estado de los trabajadores, editor de salvaguardas, navegador de memoria, registro de decisiones y flujo de registros 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

Desarrollo

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)

Requisitos: Node 24+, pnpm 10+.

Licencia

MIT