nucleus — MCP-сервер для Claude Code: что делает и как установить
Ведёт журнал решений и единую память для агентов в папке .brain. Сервер связывает контекст сессий между разными редакторами без векторных баз данных.
claude mcp add --transport http nucleus https://relay.nucleusos.dev/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 остановится на этапе плана.
Какие задачи решает
- сохранять контекст архитектурных решений между сессиями ИИ
- проверять правки кода через многоуровневый контур верификации
- синхронизировать память ассистентов в разных редакторах
- отслеживать глубину погружения в подзадачи через локальный стек
Примеры запросов агенту
- Сохрани принятое архитектурное решение по авторизации в журнал
.brain - Запусти проверку соблюдения правил проекта через
nucleus review - Покажи текущую глубину стека задач через
nucleus-rabbithole
Как установить nucleus
1Командой платформы: удалённый сервер
claude mcp add --transport http nucleus https://relay.nucleusos.dev/mcp2Командой платформы
claude mcp add --env NUCLEUS_BRAIN_PATH=<NUCLEUS_BRAIN_PATH> --transport stdio nucleus -- uvx nucleus-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from nucleus-mcp <команда>
1Командой платформы: удалённый сервер
codex mcp add nucleus --url https://relay.nucleusos.dev/mcp2Командой платформы
codex mcp add nucleus --env NUCLEUS_BRAIN_PATH=<NUCLEUS_BRAIN_PATH> -- uvx nucleus-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from nucleus-mcp <команда>
Файл настроек
{
"mcpServers": {
"nucleus": {
"url": "https://relay.nucleusos.dev/mcp"
}
}
}{
"mcpServers": {
"nucleus": {
"command": "uvx",
"args": [
"nucleus-mcp"
],
"env": {
"NUCLEUS_BRAIN_PATH": "<NUCLEUS_BRAIN_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from nucleus-mcp <команда>
Файл настроек
{
"servers": {
"nucleus": {
"type": "http",
"url": "https://relay.nucleusos.dev/mcp"
}
}
}{
"servers": {
"nucleus": {
"type": "stdio",
"command": "uvx",
"args": [
"nucleus-mcp"
],
"env": {
"NUCLEUS_BRAIN_PATH": "<NUCLEUS_BRAIN_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from nucleus-mcp <команда>
1Командой платформы: удалённый сервер
gemini mcp add -t http nucleus https://relay.nucleusos.dev/mcp2Командой платформы
gemini mcp add -e NUCLEUS_BRAIN_PATH=<NUCLEUS_BRAIN_PATH> nucleus uvx nucleus-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from nucleus-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о nucleus
Как установить nucleus в Claude Code?
Выполните в терминале команду claude mcp add --env NUCLEUS_BRAIN_PATH=<NUCLEUS_BRAIN_PATH> --transport stdio nucleus -- uvx nucleus-mcp.
Что делает сервер nucleus?
Он создаёт каталог .brain в репозитории и открывает агентам доступ к инструментам записи решений, долговременной памяти и проверки правок.
Что нужно для работы nucleus build?
Команде необходим установленный в PATH и авторизованный CLI одного из кодовых агентов: claude, devin или agy. Без рабочей сессии генерация остановится на стадии плана.
