brainbox — MCP-сервер для Claude Code: память агента
Запоминает, какие файлы агент читает и правит вместе, и подставляет нужные до начала поиска. Пригодится, когда каждая новая задача в проекте начинается с долгого grep.
claude mcp add brainbox -- npx -y brainbox-hebbianЧто делает brainbox
brainbox собирает локальный граф на SQLite: файлы, инструменты и ошибки становятся узлами, а то, что агент трогает подряд, — связями между ними. При следующем запросе сервер поднимает соседей уже найденного файла на несколько шагов вглубь и отдаёт агенту готовый список. Разбор идёт по нескольким каналам ранжирования сразу, поэтому в выдаче видно, какая связь привела файл в подсказку.
Отдельная ветка — ошибки. Если команда упала, потом пошли правки и повторный запуск прошёл, сервер запоминает связку «отпечаток ошибки → файлы, которые её починили». Тот же отпечаток в следующий раз сразу вытягивает эти файлы. Частые маршруты по файлам укрепляются, редкие связи слабеют, так что подсказки подстраиваются под то, чем вы реально заняты.
Нужен Node 22 и больше ничего для базового режима. До того как скачается модель эмбеддингов (brainbox models pull), поиск идёт по ключевым словам; если нативные модули не собираются на вашей машине, сервер всё равно ставится и работает в этом режиме — режим показывает brainbox models status. Холодный старт можно снять загрузкой из истории git: brainbox bootstrap --repo /path/to/project --imports. Ставится пакетом npm install brainbox-hebbian, который сам прописывает хуки и регистрирует сервер.
Какие задачи решает
- подставлять нужные файлы до того, как агент начнёт искать их grep-ом
- связать отпечаток ошибки с файлами, которые её однажды исправили
- держать память о правках локально, без обращений к внешнему API
- засеять связи из истории git, чтобы не ждать накопления опыта
- посмотреть, почему конкретный файл попал в подсказку
Примеры запросов агенту
- Покажи, что brainbox помнит по
auth.ts, и объясни, откуда эта связь - Я получил ошибку
TypeError: cannot read property— найди файлы, которыми её чинили в прошлый раз - Загрузи память из истории репозитория
/path/to/projectвместе с импортами
Как установить brainbox
Командой платформы
claude mcp add brainbox -- npx -y brainbox-hebbianКомандой платформы
codex mcp add brainbox -- npx -y brainbox-hebbianФайл настроек
{
"mcpServers": {
"brainbox": {
"command": "npx",
"args": [
"-y",
"brainbox-hebbian"
]
}
}
}Файл настроек
{
"servers": {
"brainbox": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"brainbox-hebbian"
]
}
}
}Командой платформы
gemini mcp add brainbox npx -y brainbox-hebbianПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о brainbox
Как установить brainbox в Claude Code?
Одной командой: claude mcp add brainbox -- npx -y brainbox-hebbian. Хуки и запись в ~/.claude/settings.json пакет прописывает сам при установке.
Что делает brainbox?
Запоминает, какие файлы, инструменты и ошибки агент трогает рядом по времени, и подставляет связанные файлы в начале следующей задачи. Всё хранится в локальной SQLite-базе.
Что будет, если модель эмбеддингов не скачалась?
Поиск останется лексическим, по ключевым словам. Сервер ставится и работает и в этом режиме, а текущий режим показывает brainbox models status.
