# ZenBrain Memory

Локальная память агента на SQLite: сервер сохраняет факты, эпизоды, процедуры и рабочий контекст между разговорами. Учётная запись не нужна.

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

## Что делает

ZenBrain Memory подключает к MCP-клиенту пять инструментов: сохранение, поиск, удаление, консолидацию и проверку состояния памяти. Запись автоматически попадает в процедурный, эпизодический, семантический или основной слой по содержимому и эмоциональному весу. Рабочая память используется только при явном запросе.

Сервер хранит данные в локальном файле SQLite и работает через stdio, без вызовов LLM и сетевых запросов. Поиск по умолчанию лексический, а не смысловой: совпадения токенов ранжируются по оценке от 0 до 1. Консолидацию нужно запускать отдельным вызовом. Node.js 22 или новее обязателен, а файл хранилища не шифруется, поэтому его путь требует осторожного выбора.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `ZENBRAIN_DB`, `ZENBRAIN_CONTEXTS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env ZENBRAIN_DB=<ZENBRAIN_DB> --env ZENBRAIN_CONTEXTS=<ZENBRAIN_CONTEXTS> --transport stdio mcp -- npx -y @zensation/mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add mcp --env ZENBRAIN_DB=<ZENBRAIN_DB> --env ZENBRAIN_CONTEXTS=<ZENBRAIN_CONTEXTS> -- npx -y @zensation/mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@zensation/mcp"
            ],
            "env": {
                "ZENBRAIN_DB": "<ZENBRAIN_DB>",
                "ZENBRAIN_CONTEXTS": "<ZENBRAIN_CONTEXTS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@zensation/mcp"
            ],
            "env": {
                "ZENBRAIN_DB": "<ZENBRAIN_DB>",
                "ZENBRAIN_CONTEXTS": "<ZENBRAIN_CONTEXTS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e ZENBRAIN_DB=<ZENBRAIN_DB> -e ZENBRAIN_CONTEXTS=<ZENBRAIN_CONTEXTS> mcp npx -y @zensation/mcp
```
Вместо <…> подставьте свои значения

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

## Примеры запросов агенту
- Запомни это решение как правило для проекта и сохрани его в памяти.
- Найди в памяти процедуры, связанные с настройкой базы данных, и покажи подходящие результаты.
- Удали память с указанным идентификатором и затем сохрани исправленную версию.

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

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