brain — the recorder — MCP-сервер для Claude Code: запись истории
Записывает сессии Claude, Codex и Pi до того, как их удалит очистка, и даёт искать по ним со ссылками на файл, строки и sha256.
claude mcp add --env BRAIN_HOME=<BRAIN_HOME> --transport stdio brain-the-recorder -- uvx brain-mcpЧто делает brain — the recorder
Claude при запуске удаляет файлы сессий старше cleanupPeriodDays (по умолчанию 30 дней). brain-mcp перехватывает их раньше: хуки Stop и SessionEnd пишут построчные дельты и финальный снимок, а фоновый сканер раз в 60 секунд обходит папку сессии целиком, включая транскрипты субагентов, .meta.json и tool-results/. Codex и Pi попадают в тот же поток через сканер.
Записи ложатся в ~/.brain/lake/<lane>/<session>.jsonl — append-only, байт в байт как в оригинале, плюс манифест с sha256 по каждому чанку. Индекс в DuckDB можно пересобрать из озера и манифеста, так что это кеш, а не единственная копия. Поиск отдаёт BM25-выдачу со ссылкой {file, line span, sha256}, проверить которую можно через sed и shasum; при нуле совпадений инструмент прямо говорит, что ничего не нашёл в просмотренных дорожках и датах.
Что нужно заранее: Python-пакет ставится через pipx или uvx, а при первой сборке индекса DuckDB скачивает расширение полнотекстового поиска fts из своего репозитория и кладёт его в ~/.duckdb. Без этой загрузки индекс не построится, поэтому в закрытом контуре её придётся предусмотреть. Телеметрии и облака в пакете нет.
Какие задачи решает
- восстановить сессию Claude, удалённую очисткой
- найти по своим прошлым диалогам нужный фрагмент с проверяемой ссылкой
- проверить, что именно агент удалил, а что сохранилось
- сделать резервную копию истории с перепроверкой хешей
- отличить свежие дорожки от устаревших и неизмеренных
Примеры запросов агенту
- Найди в моей истории, что я писал про миграцию на
brain_search(query="миграция", role="user") - Покажи, что удалили агенты, через
brain_health - Восстанови сессию:
brain-mcp restore --list, потомbrain-mcp restore <id>
Как установить brain — the recorder
Командой платформы
claude mcp add --env BRAIN_HOME=<BRAIN_HOME> --transport stdio brain-the-recorder -- uvx brain-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from brain-mcp <команда>
Командой платформы
codex mcp add brain-the-recorder --env BRAIN_HOME=<BRAIN_HOME> -- uvx brain-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from brain-mcp <команда>
Файл настроек
{
"mcpServers": {
"brain-the-recorder": {
"command": "uvx",
"args": [
"brain-mcp"
],
"env": {
"BRAIN_HOME": "<BRAIN_HOME>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from brain-mcp <команда>
Файл настроек
{
"servers": {
"brain-the-recorder": {
"type": "stdio",
"command": "uvx",
"args": [
"brain-mcp"
],
"env": {
"BRAIN_HOME": "<BRAIN_HOME>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from brain-mcp <команда>
Командой платформы
gemini mcp add -e BRAIN_HOME=<BRAIN_HOME> brain-the-recorder uvx brain-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from brain-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о brain — the recorder
Как установить brain — the recorder в Claude Code?
Через маркетплейс плагинов: сначала /plugin marketplace add mordechaipotash/brain-marketplace, затем /plugin install brain. Хуки и сервер ставятся одной командой.
Что делает brain — the recorder?
Сохраняет сессии Claude, Codex и Pi до удаления, индексирует их и даёт искать с цитатами, которые можно проверить хешем. Отдельно показывает, что именно пропало, и умеет вернуть сессию на место.
Что нужно для работы сервера?
Пакет ставится через pipx или uvx. При первой сборке индекса DuckDB скачивает расширение fts из своего репозитория и кеширует его в ~/.duckdb.
