Claude History MCP
Claude History MCP индексирует прошлые беседы Claude Code, достает решения и исправления ошибок и подставляет контекст проекта
- 69 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Сервер читает все транскрипты Claude Code, где могут быть ключи и личные данные, и строит из них индекс на диске
- Инструменты cloud_sync отправляют знания и сессии на удаленный сервер, а хук правит `~/.claude/settings.json`
Установка
- Работает в
Ручная установка
claude mcp add claude-history -- node "/path/to/ClaudeHistoryMCP/dist/index.js"После `npm install`, `npm run build` и `npm run build-index` в клоне репозитория.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сервер читает все транскрипты Claude Code, где могут быть ключи и личные данные, и строит из них индекс на диске
- Инструменты cloud_sync отправляют знания и сессии на удаленный сервер, а хук правит `~/.claude/settings.json`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Claude Code хранит полные транскрипты в виде файлов JSONL в `~/.claude/projects/`. Сервер индексирует их гибридным поиском: BM25 дает точность по ключевым словам, TF-IDF добавляет смысловой охват, результаты объединяются методом Reciprocal Rank Fusion. В запросе работают фильтры `project:`, `before:7d`, `after:` и `tool:Bash`, свежие беседы и совпадение с текущей папкой повышают оценку. После окончания сессии, когда файл не меняется пять минут, сервер извлекает решения, исправления и пары «ошибка и ее устранение». Инструменты `search_history`, `find_solutions`, `get_session_summary`, `list_projects`, `find_patterns` и `get_project_context` отдают найденное агенту. Дополнительно можно поставить хук `SessionStart`, который подмешивает историю проекта в новую сессию, и скилл `/claude-history`. Индекс обновляется сам при появлении новых файлов, на 170 сессий он собирается около 9 секунд.
Для кого. Пользователям Claude Code с большой историей сессий, которым нужно быстро находить, как раньше решали задачу или исправляли ошибку.
Подходит, если
- Неделю назад починили падающий тест, и надо найти ту сессию
- Новая сессия в проекте должна начинаться с решений и контекста прошлых
- Повторяющиеся темы и проблемы нужно увидеть по всем проектам
- Краткая выжимка конкретной сессии берется по идентификатору
- Поиск ограничивается проектом и периодом, например `project:api before:7d`
Не подходит, если
- Нужна память о предпочтениях пользователя: сервер ищет по истории, а профиль не строит
- Беседы нельзя индексировать из-за конфиденциальных данных в транскриптах
- Вы работаете не в Claude Code: индексируются только его файлы JSONL
Пример запроса к агенту
Найди в истории, как мы чинили ошибку подключения к базе в проекте api, и покажи ту сессиюMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Сервер читает все транскрипты из `~/.claude/projects/` и хранит индекс и извлеченные знания в `~/.claude-history-mcp/`. В README есть инструменты `cloud_sync_push`, `cloud_sync_pull` и `cloud_sync_status`, которые отправляют знания и сессии на облачный сервер: включать их стоит осознанно. Установка идет из клона репозитория через `npm install` и `npm run build`, пакета в реестре нет. Хук и скилл ставятся отдельной командой `npm run install-hook` и меняют `~/.claude/settings.json`. Извлечение знаний работает по шаблонам фраз вроде «decided to» и «fixed».
Как отключить. Удалите запись `claude mcp remove claude-history`, выключите хук в `~/.claude/settings.json` и удалите папку `~/.claude-history-mcp/` с индексом.
Частые вопросы
Как подключить Claude History MCP?
Соберите проект командами `npm install` и `npm run build`, постройте индекс `npm run build-index` и выполните `claude mcp add claude-history -- node "/path/to/ClaudeHistoryMCP/dist/index.js"`.
Какие инструменты есть у сервера?
Шесть для работы с историей: `search_history`, `find_solutions`, `get_session_summary`, `list_projects`, `find_patterns`, `get_project_context`. Три дополнительных управляют облачной синхронизацией.
Что делает хук SessionStart?
Он подмешивает в начало новой сессии релевантную историю проекта. Ставится командой `npm run install-hook` и необязателен.
Как быстро строится индекс?
Около 9 секунд на 170 сессий, поиск занимает меньше 200 мс, новые файлы подхватываются автоматически.
Чем отличается от просмотрщиков истории?
Просмотрщики показывают беседы людям, а сервер отдает поиск и найденные решения самому агенту через инструменты MCP.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный поиск по всей истории сессий Claude Code: решения, команды, значения переменных и уже написанный код через 13 MCP-инструментов
Копирует сессии Claude Code и Codex до автоудаления и отвечает по ним цитатой с хешем или честным отказом.
Проект для Claude Code с набором MCP-серверов и хуков: долгая память, потребности, социальный контекст, камера, голос и датчики
claude-mem-lite хранит решения, исправления и контекст сессий Claude Code в одной базе SQLite и находит их полнотекстовым поиском
Плагин Supermemory для Claude Code: долговременная память между сессиями с автоматическим поиском по подсказке, сохранением диалога и индексом кодовой базы
Конфигурация Claude Code с защитами: подтверждения опасных действий, аудит команд, подагенты и 65 MCP-серверов по запросу.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Claude History MCP (эта карточка) | нет | не нужна | 69 | |
| OpenHistory | нет | API-ключ | 137 | похожий сервер поиска по истории, здесь гибридный BM25 с TF-IDF, извлечение решений и хук контекста проекта |
| Claude Code History Viewer | нет | 2 314 | просмотрщик бесед для человека, сервер дает поиск и найденные решения самому агенту |
Коротко о README
README объясняет, что сервер делает с историей Claude Code, и показывает схему из сервера, скилла и хука. Затем описаны поисковый движок, извлечение знаний, хранение данных, установка в четыре шага и таблица девяти инструментов.