claude-operator

MCP-сервер на TypeScript, который превращает любую сессию Claude Code в автономного оператора — он декомпозирует цели, запускает и координирует рабочие сессии в нескольких проектах, управляет двухуровневой постоянной памятью, обеспечивает соблюдение правил безопасности и обучается на основе ретроспективных отзывов пользователей.

Установка

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

init создает структуру ~/.claude-operator/ (база данных SQLite, директория шины, конфигурация). start запускает MCP-сервер через stdio + панель управления по адресу 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

Двухуровневая память — уровень 1 (энергозависимая, автоматическое удаление через 30 дней) и уровень 2 (постоянная, подтвержденная человеком). Оператор предлагает классификацию; человек подтверждает её в панели управления (pending_classification=TRUE).

Файловая шина — основной канал состояния между рабочим процессом и оператором. Рабочие процессы записывают сигналы «heartbeat» в <bus-dir>/<worker-id>.json; цикл мониторинга обнаруживает зависшие процессы (отсутствие сигнала более 2 минут) и помечает их как завершившиеся с ошибкой.

Правила безопасности (Guardrails) — JSON-правила, проверяемые перед любым вызовом инструмента. Устанавливаются через set_guardrail, просматриваются через get_guardrails.

Справочник инструментов

Панель управления

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