brain-mcp
Копирует сессии Claude Code и Codex до автоудаления и отвечает по ним цитатой с хешем или честным отказом.
- 81 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Хуки копируют все транскрипты сессий на диск, а в них бывают секреты и приватный код.
- Сервер читает домашние каталоги Claude Code, Codex и Pi и пишет в `~/.brain`.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/brain-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки копируют все транскрипты сессий на диск, а в них бывают секреты и приватный код.
- Сервер читает домашние каталоги Claude Code, Codex и Pi и пишет в `~/.brain`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
brain-mcp пишет историю сессий агентов на локальный диск и отдает ее по MCP. Claude Code при запуске удаляет файлы сессий старше `cleanupPeriodDays` (по умолчанию 30 дней), и рекордер успевает скопировать их раньше: сессию целиком, вместе с транскриптами субагентов и сохраненным выводом инструментов. Копии лежат в `~/.brain/lake` как append-only файлы с манифестом sha256, поиск работает по индексу DuckDB. Каждый найденный фрагмент приходит с файлом, диапазоном строк и хешем, так что ответ проверяют командами `sed` и `shasum`. Если совпадений нет, сервер так и сообщает и перечисляет просмотренные источники. Команда `brain-mcp restore` возвращает удаленную сессию на место, после чего ее продолжают через `claude --resume`.
Для кого. Тем, кто работает в Claude Code или Codex каждый день и не хочет терять старые решения, команды и обсуждения после очистки истории.
Подходит, если
- Вы ищете, как полтора месяца назад чинили падающую миграцию, а Claude Code уже удалил ту сессию.
- Нужна цитата с номерами строк и хешем, которую проверит коллега без доступа к вашей базе.
- Вы хотите узнать, какие сессии агент удалил за последние недели, и вернуть нужную.
- Одна история должна покрывать Claude Code, Codex и Pi, три отдельных архива не нужны.
Не подходит, если
- Транскрипты содержат секреты, и хранить их копии на диске вы не готовы.
- Нужна синхронизация истории между машинами или облачный бэкап без самостоятельной настройки.
- Вам хватает коротких сессий, которые вы не открываете повторно.
Пример запроса к агенту
Найди в записанных сессиях обсуждение падающей миграции и покажи цитату с файлом, строками и хешем.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Рекордер хранит расшифровки целиком, а в них попадают пути, фрагменты кода и все, что вы вставляли в чат. Закройте доступ к `~/.brain` так же, как к домашней папке. Во время первой сборки индекса DuckDB один раз скачивает расширение полнотекстового поиска из собственного репозитория расширений. Телеметрии, облака и HTTP-клиента в пакете нет. Резервную копию в другое место делает команда `brain-mcp backup`, а восстановление работает только через CLI. Статус `unknown` обозначает неизмеренный источник, исправным его считать нельзя.
Как отключить. Удалите плагин или MCP-подключение и снимите хуки командой из документации. Каталог `~/.brain` с копиями сессий стирайте отдельно, когда он больше не нужен.
Частые вопросы
Какие инструменты MCP есть?
Семь: `brain_search` ищет по записанному, `brain_get` отдает сырые строки с проверкой хеша, `brain_recent` показывает свежую активность, `brain_sessions` собирает карточки сессий по дням, `brain_health` сообщает о свежести и об удаленном агентами, `brain_capture_status` показывает, движется ли захват.
Как вернуть удаленную сессию?
Выполните `brain-mcp restore --list`, выберите идентификатор и запустите `brain-mcp restore <id>`. Команда пишет сессию на место побайтно и не перезаписывает отличающиеся файлы. Флаги `--dry-run` и `--to <dir>` дают сначала посмотреть результат.
Откуда рекордер берет сессии?
Claude Code пишется хуками Stop и SessionEnd, а Codex и Pi читаются опросом каждые 60 секунд. Пути: `~/.claude/projects`, `~/.codex/sessions` и `~/.pi/agent/sessions`.
Что делать, если здоровье показывает unknown?
Статус значит, что источник не измерен. Запустите `brain-mcp doctor`: он покажет состояние захвата, свежесть и наличие кеша расширения.
Как сделать резервную копию?
Команда `brain-mcp backup <dest>` синхронизирует хранилище и манифест в указанное место и перепроверяет хеши выборочных файлов. Проверка может завершиться ошибкой, и это предусмотрено.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыClaude History MCP индексирует прошлые беседы Claude Code, достает решения и исправления ошибок и подставляет контекст проекта
Долговременная память для Claude Code, Cursor и Codex: агент сохраняет решения и находит их в следующих сессиях
Локальный поиск по всей истории сессий Claude Code: решения, команды, значения переменных и уже написанный код через 13 MCP-инструментов
MCP-сервер сохраняет контекст Claude Code между сеансами: решения, контрольные точки и кэш файлов хранятся в локальной SQLite.
MemoMind MCP дает Claude Code память по проектам: сохраненные факты, события и выводы доступны в локальной панели.
MCP-сервер хранит решения и знания проекта в Redis или Valkey и достает их в новых сессиях и после сжатия контекста.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| brain-mcp (эта карточка) | нет | не нужна | 81 | |
| Claude-Mem | нет | 116 457 | сохраняет наблюдения из сессий и подставляет их в новые; brain-mcp хранит исходные байты и отвечает проверяемой цитатой | |
| Episodic Memory | нет | 499 | ищет по смыслу в переписке с агентами; brain-mcp хранит побайтные копии после автоудаления и умеет восстанавливать сессии |
Коротко о README
Установка идет через `pipx` или `uvx`, затем `brain-mcp install cc` ставит хуки Claude Code и планировщик на 60 секунд. Сервер запускается командой `brain-mcp serve` по stdio. Есть и вариант плагина Claude Code.