ZenBrain MCP
Память для агентов по MCP: пять инструментов, локальный файл SQLite и слои, как в человеческой памяти, без аккаунта
- 27 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Сервер пишет и удаляет данные в локальном файле памяти, zenbrain_forget стирает запись вместе со связанными
- Содержимое сессий агента копится в файле, который остается на диске
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/zenbrainОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер пишет и удаляет данные в локальном файле памяти, zenbrain_forget стирает запись вместе со связанными
- Содержимое сессий агента копится в файле, который остается на диске
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ZenBrain добавляет агенту память, которая сохраняется между сессиями. MCP-сервер @zensation/mcp работает в Claude Code, Claude Desktop и Cursor, хранит все в одном локальном файле SQLite и не ходит в сеть. Пять инструментов: zenbrain_store записывает память, zenbrain_recall ищет по слоям, zenbrain_forget удаляет запись вместе со связанными, zenbrain_consolidate делает проход обслуживания, zenbrain_health показывает заполнение слоев. Память устроена в семь слоев: рабочая, краткосрочная, эпизодическая, долговременная семантическая, процедурная, ядро и межконтекстная. При записи слой выбирается автоматически: шаги и фразы вроде "How to" дают процедуру, эмоциональный вес выше 0.5 дает эпизод, уверенность выше 0.9 закрепляет факт в ядре, остальное становится семантическим фактом. Консолидация превращает эпизоды с большим весом в факты. В основе лежит библиотека @zensation/algorithms с модулями повторения с интервалами, хеббовского усиления, воспроизведения во сне и эмоциональных меток. Ее можно подключить в свой код отдельно.
Для кого. Разработчикам, чей агент каждый раз начинает с нуля и кому нужна локальная память без облака и аккаунта.
Подходит, если
- Агент в Claude Code должен помнить принятые в проекте решения от сессии к сессии
- Пошаговые инструкции вроде "How to `deploy`" сохраняют как процедуры и достают по запросу
- Эпизоды с эмоциональным весом выше 0.5 сводят в факты периодическим проходом `consolidate`
- Нужна локальная память для Cursor или Claude Desktop, которая не отправляет данные никуда
- Исследователь воспроизводит абляции механизмов памяти из статьи командой npm `run` `experiments`
Не подходит, если
- Память должна быть общей для нескольких пользователей и серверов: MCP-сервер использует один локальный файл
- Требуется векторный поиск по эмбеддингам из коробки: поиск по слоям идет лексически
- Ожидается память со всеми шестью проприетарными компонентами из статьи: в пакетах их нет
- Расписание повторения фактов должно двигаться: ни один инструмент не отмечает повторение
Пример запроса к агенту
Запомни, что в этом проекте миграции пишем только вручную, и напомни мне об этом в следующей сессии при работе с базой.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
ZENBRAIN_DB- Путь к файлу SQLite, по умолчанию ./zenbrain.db, значение :memory: дает хранилище на время процесса.
ZENBRAIN_CONTEXTS- Список областей через запятую, сейчас на работу пяти инструментов не влияет.
Ограничения
Проект до версии 1.0: набор инструментов небольшой и может измениться. Шесть компонентов Predictive Memory Architecture из статьи закрыты и в пакеты не входят. Цифры сравнения на LongMemEval-500 получены тестовой обвязкой на Python, как сказано в уведомлении об исправлении, а не этим пакетом. Нужен Node.js 22 или новее. Путь к файлу в ZENBRAIN_DB лучше задавать абсолютным или с ~/, иначе клиент может запустить сервер в каталоге без права записи. Все слои живут в одном локальном файле, общего хранилища для команды нет.
Как отключить. В Claude Code выполните claude mcp `remove` zenbrain или claude plugin `uninstall` zenbrain. Файл памяти лежит по пути из ZENBRAIN_DB, например ~/.zenbrain/memory.db, и удаляется вручную.
Частые вопросы
Как подключить ZenBrain к Claude Code?
Выполните claude mcp add --scope user zenbrain -e ZENBRAIN_DB=~/.zenbrain/memory.db -- npx -y @zensation/mcp. Тот же сервер ставится плагином: claude plugin install zenbrain --marketplace zensation-ai/zenbrain.
Где хранится память и уходят ли данные в сеть?
Память лежит в одном файле SQLite по пути из ZENBRAIN_DB, сервер не делает сетевых вызовов. Эмбеддинг-модель или LLM подключаются по желанию, по умолчанию ранжирование лексическое.
Какие инструменты помечены как опасные?
zenbrain_forget и zenbrain_consolidate отмечены в аннотациях MCP как разрушающие, поэтому клиент, который спрашивает подтверждение, спросит и здесь. zenbrain_recall и zenbrain_health только читают.
Чем ZenBrain отличается от Mem0?
ZenBrain хранит память локально в SQLite и дает пять инструментов с семью слоями, как в статье. Mem0 развивается как слой памяти с плагинами и SDK для нескольких агентов.
Можно ли использовать алгоритмы без MCP?
Да. Установите библиотеку npm install @zensation/algorithms, она написана на TypeScript без сторонних зависимостей и требует Node.js 22 или новее.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыПостоянная память агента на графе связей: решения и ошибки переживают сессию, без векторной базы и платных вызовов API
Локальная память для агента: хуки сами записывают факты из разговоров, а MCP-сервер возвращает их в новых сессиях из файла SQLite
MCP-сервер долговременной памяти для ИИ-агентов: факты стареют по кривой забывания, связанные записи сжимаются в сводку
Самостоятельный MCP-сервер долговременной памяти для агентов: структурированные записи, версии с откатом и визуальная панель
Membase хранит одну общую память для ИИ-агентов, и Claude Code, Cursor и Codex читают ее через MCP, SDK или команду membase
MCP-сервер долговременной памяти для агентов: один бинарник на Rust, который работает офлайн и не вызывает языковую модель
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ZenBrain (эта карточка) | да | не нужна | 27 | |
| Mem0 | нет | 68 514 | слой памяти с плагинами и SDK для нескольких агентов, а не локальный MCP-сервер из пяти инструментов | |
| Claude-Mem | нет | 113 534 | плагин, который сохраняет наблюдения из сессий и подставляет контекст в новые |
Коротко о README
README делится на пакеты: библиотеку алгоритмов, MCP-сервер, плагин для Claude Code и `middleware` для Vercel AI SDK. Раздел про измерения приводит результаты LongMemEval-500, сравнение механизмов с Mem0, Letta и Zep и пакеты воспроизведения на Zenodo. Там же указаны оговорки к цифрам.