Nucleus

MCP-сервер, который делает результаты работы ИИ надежнее с каждой неделей.

ИИ-агенты галлюцинируют, ломают код и повторяют ошибки. Nucleus это исправляет. Каждый результат работы ИИ проверяется, каждое исправление записывается, и каждая ошибка обучает систему не повторять её. Локально, на вашем компьютере.

Три рубежа

Основной цикл, который делает надежность ИИ кумулятивной с течением времени:

  GROUND              ALIGN               COMPOUND
  ──────              ─────               ────────
  Machine verifies    Human corrects      System learns

  AI writes code  →  You fix a mistake →  Delta recorded
  GROUND checks   →  Verdict stored    →  DPO pair created
  Receipt logged  →  Event emitted     →  Training data grows
       │                   │                    │
       └───────────────────┴────────────────────┘
                    Reliability improves

GROUND (Основа) — 5-уровневая проверка выполнения. Синтаксис, импорты, тесты, среда выполнения. Выходит за рамки формальной системы для проверки работы ИИ.

ALIGN (Выравнивание) — Исправления в один вызов. nucleus_align(action="correct", params={context, correction}). Каждое исправление автоматически записывает вердикт, создает пару для обучения и генерирует событие.

COMPOUND (Накопление) — Дельты измеряют разрыв между намерением и реальностью. Повторяющиеся паттерны становятся стратегией. Отрицательные дельты становятся сигналом для обучения.

Каждый ответ инструмента показывает состояние рубежей:

[frontiers: GROUND 42 | ALIGN 12 | COMPOUND 28]

Быстрый старт

pip install nucleus-mcp
nucleus init --recipe founder

Две команды. Nucleus запущен. Результаты работы ИИ теперь проверяются.

Что он делает

114 инструментов MCP в 14 категориях:

• GROUND — Проверка выполнения (5 уровней: diff, синтаксис, импорты, тесты, среда выполнения)

• ALIGN — Исправления человеком (вердикт + дельта + DPO + событие в одном вызове)

• Memory (Память) — Энграммы, которые сохраняются между сессиями. Запишите один раз, вспоминайте всегда.

• Sessions (Сессии) — Сохранение контекста, возобновление позже. Дуга сессии показывает ваши последние 3 сессии.

• Tasks (Задачи) — Очередь приоритетов с эскалацией, контролем человека (HITL) и мониторингом работоспособности.

• Governance (Управление) — Аварийное отключение, конфигурации соответствия требованиям (EU DORA, MAS TRM, SOC2), журналы аудита.

• Orchestration (Оркестрация) — Слоты агентов, синхронизация нескольких «мозгов», распределение задач.

• Archive (Архив) — Конвейер обучения (SFT + DPO), отслеживание дельт, панель мониторинга состояния рубежей.

Nucleus Pro

Все вышеперечисленное бесплатно (MIT). Nucleus Pro добавляет проверяемое управление:

nucleus trial                              # 14-day free trial
nucleus compliance-check                   # Score your AI governance
nucleus audit-report --signed -o report.html  # Cryptographically signed report

$19/месяц или $149/год — nucleusos.dev/pricing

Установка

В один клик

pip / npx

pip install nucleus-mcp

Или используйте npx (настройка Python не требуется):

npx -y nucleus-mcp

Настройка вашего MCP-клиента

Claude Desktop / Cursor / Windsurf

Добавьте в конфигурацию MCP (claude_desktop_config.json или эквивалент):

{
  "mcpServers": {
    "nucleus": {
      "command": "npx",
      "args": ["-y", "nucleus-mcp"]
    }
  }
}

{
  "mcpServers": {
    "nucleus": {
      "command": "python3",
      "args": ["-m", "mcp_server_nucleus"],
      "env": {
        "NUCLEAR_BRAIN_PATH": "/path/to/your/project/.brain"
      }
    }
  }
}

Claude Code

Добавьте в .mcp.json в корне вашего проекта:

{
  "mcpServers": {
    "nucleus": {
      "command": "npx",
      "args": ["-y", "nucleus-mcp"]
    }
  }
}

Обнаружение пути

Nucleus находит ваш .brain автоматически:

1. Переменная окружения NUCLEAR_BRAIN_PATH (явно)

2. Поиск вверх от текущей рабочей директории (CWD) в поисках папки .brain/

3. Резервный вариант $HOME/.nucleus/brain

CLI

Nucleus имеет полноценный CLI наряду с инструментами MCP. Автоматически определяет TTY (вывод в виде таблицы) или pipe (JSON).

# Memory
nucleus engram write my_key "insight here" --context Decision --intensity 7
nucleus engram search "compliance"
nucleus engram query --context Strategy --limit 10

# Tasks
nucleus task list --status READY
nucleus task add "Ship the feature" --priority 1

# Sessions
nucleus session save "Working on auth refactor"
nucleus session resume

# Health
nucleus status --health
nucleus sovereign

# Compliance
nucleus comply --jurisdiction eu-dora
nucleus audit-report --format html -o report.html

# Chat (multi-provider: Gemini, Anthropic, Groq)
nucleus chat

Для использования в конвейерах (pipe-friendly):

nucleus engram search "test" | jq '.key'
nucleus task list --format tsv | cut -f1,3

Соответствие требованиям

Настройка одной командой для регуляторных фреймворков:

nucleus comply --jurisdiction eu-dora       # EU DORA
nucleus comply --jurisdiction sg-mas-trm    # Singapore MAS TRM
nucleus comply --jurisdiction us-soc2       # US SOC2

Телеметрия

Nucleus собирает анонимную, агрегированную статистику использования (имя команды, длительность, тип ошибки, версии, ОС). Никакого содержимого энграмм, путей к файлам, промптов, API-ключей или персональных данных — никогда.

nucleus config --no-telemetry
# or: NUCLEUS_ANON_TELEMETRY=false

Подробности см. в TELEMETRY.md.

Участие в разработке

• Ошибка? Откройте Issue

• Идея функции? Начните Discussion

• Код? См. CONTRIBUTING.md

• Чат? Discord

Лицензия

MIT © 2026 | hello@nucleusos.dev