# nucleus

Ведёт журнал решений и единую память для агентов в папке .brain. Сервер связывает контекст сессий между разными редакторами без векторных баз данных.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Автор: eidetic-works
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/eidetic-works/nucleus-mcp
- Обновлён: 2026-10-02
- HTML: https://affpapa.org/nevibecode/mcp/nucleus

## Что делает

Хранит историю решений и правил проекта прямо в репозитории внутри каталога `.brain` в формате JSON и Markdown. MCP-сервер передаёт этот контекст кодовым ассистентам. Это избавляет от повторных объяснений архитектуры в новых сессиях.

В бесплатный пакет входят три десятка инструментов и отдельная утилита `nucleus-rabbithole` на SQLite для отслеживания глубины погружения в задачи. Контроль кода опирается на контуры верификации GROUND, ALIGN и COMPOUND.

Для работы нужен Python версии 3.10 или новее. На Python 3.14 часть зависимостей собирается из исходников, поэтому надёжнее брать версии от 3.11 до 3.13. Удалённый endpoint сейчас отозван разработчиками на аудит безопасности. Утилита `nucleus build` без авторизованного CLI вроде `claude` остановится на этапе плана.

## Требования
- Нужно: Python и uv (команды через uvx)
- Удалённый сервер: `https://relay.nucleusos.dev/mcp`
- Переменные окружения: `NUCLEUS_BRAIN_PATH` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http nucleus https://relay.nucleusos.dev/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env NUCLEUS_BRAIN_PATH=<NUCLEUS_BRAIN_PATH> --transport stdio nucleus -- uvx nucleus-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from nucleus-mcp <команда>

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add nucleus --url https://relay.nucleusos.dev/mcp
```

2. **Командой платформы**
```bash
codex mcp add nucleus --env NUCLEUS_BRAIN_PATH=<NUCLEUS_BRAIN_PATH> -- uvx nucleus-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from nucleus-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nucleus": {
            "url": "https://relay.nucleusos.dev/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nucleus": {
            "command": "uvx",
            "args": [
                "nucleus-mcp"
            ],
            "env": {
                "NUCLEUS_BRAIN_PATH": "<NUCLEUS_BRAIN_PATH>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from nucleus-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "nucleus": {
            "type": "http",
            "url": "https://relay.nucleusos.dev/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "nucleus": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "nucleus-mcp"
            ],
            "env": {
                "NUCLEUS_BRAIN_PATH": "<NUCLEUS_BRAIN_PATH>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from nucleus-mcp <команда>

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http nucleus https://relay.nucleusos.dev/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e NUCLEUS_BRAIN_PATH=<NUCLEUS_BRAIN_PATH> nucleus uvx nucleus-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from nucleus-mcp <команда>

## Когда брать
- сохранять контекст архитектурных решений между сессиями ИИ
- проверять правки кода через многоуровневый контур верификации
- синхронизировать память ассистентов в разных редакторах
- отслеживать глубину погружения в подзадачи через локальный стек

## Примеры запросов агенту
- Сохрани принятое архитектурное решение по авторизации в журнал `.brain`
- Запусти проверку соблюдения правил проекта через `nucleus review`
- Покажи текущую глубину стека задач через `nucleus-rabbithole`

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 392262
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33989
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81163
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119231
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47577
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43902

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md