Claude Historian MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

Два инструмента: «поиск» (11 областей) и «проверка» (сводка сеанса).
Чтение из ~/.claude/conversations/ — без внешнего сервиса
TF-IDF + нечеткое сопоставление с обнаружением шаблонов рабочего процесса
Параллельное сканирование проекта; нет постоянного индекса для поддержания
Поддерживаются идентификаторы сеансов с коротким префиксом

Живое демо

Как выглядит на практике

claude-historian-mcp.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-historian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-historian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-historian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-historian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-historian-mcp",
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-historian-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "claude-historian-mcp"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add claude-historian-mcp -- npx -y claude-historian-mcp

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Claude Historian

Узнайте, как вы исправляли подобную ошибку раньше

👤 Разработчики, которые используют Claude Code во многих сеансах. ⏱ ~5 min beginner

Когда использовать: Вы столкнулись с ошибкой, которая кажется вам знакомой; вы хотите увидеть, что сработало в прошлый раз.

Предварительные требования

Клод Код с существующей историей разговоров — По умолчанию — история хранится в ~/.claude/conversations/

Поток

Ошибки поиска

Найдите в моей истории «ECONNREFUSED redis» — область действия: ошибки.✓ Скопировано

→ Ранжированный список предыдущих сессий, в которых возникла эта ошибка
Осмотрите лучший хит

Проверьте сеанс abc12345 — какое исправление было исправлено?✓ Скопировано

→ В сводке указывается основная причина и примененное исправление.

Итог: Конкретный прецедент за считанные секунды, а не повторная отладка с нуля.

Подводные камни

Доверять резюме, не читая сессию — Используйте проверку для получения сводки, затем откройте файл сеанса для фактических различий.

Сочетать с: filesystem

Поднимите прошлый план реализации для повторного использования.

👤 Любой, кто часто планирует задачи с Клодом. ⏱ ~10 min beginner

Когда использовать: Новая функция похожа на ту, которую вы планировали несколько месяцев назад — вы хотите вернуть скелет.

Поток

Планы поиска

Область поиска: планы для «повторения фонового задания с экспоненциальной задержкой».✓ Скопировано

→ Обращения включают заголовки плана и идентификатор сеанса.
Осмотрите и адаптируйте

Осмотрите верхний хит; обобщить план и адаптировать его для очередей, поддерживаемых Postgres.✓ Скопировано

→ Адаптированный план в той же структуре, что и оригинал.

Итог: Повторное использование мышления без повторного создания каркаса.

Сочетать с: codebase-memory

Теплый старт нового сеанса с прошлым контекстом

👤 Пользователи тяжелого кода Клода ⏱ ~10 min intermediate

Когда использовать: Вы начинаете новый чат по старому проекту и не хотите заново объяснять контекст.

Поток

Поиск упоминаний проекта

Область поиска: сеансы для «выставления счетов acme-api», сгруппированные по проектам.✓ Скопировано

→ 3–5 наиболее релевантных сессий для этого проекта.
Осмотр на предмет гидратации

Проверьте сеанс 7f3e2a10. Обобщить архитектурные решения и известные ошибки.✓ Скопировано

→ Чистое резюме, лежащее в основе новой сессии

Итог: Новый сеанс начинается с того места, на котором остановился последний полезный сеанс.

Подводные камни

Загрузка слишком большого количества сеансов одновременно и утопление в контексте — Выход в топ-5 по количеству очков; используйте проверку только для лучшего

Сочетать с: memory-bank-mcp

Комбинации

Сочетайте с другими MCP — эффект x10

claude-historian-mcp + filesystem

После проверки откройте файлы, на которые ссылаются, для фактических различий.

Проверьте сеанс X. Затем откройте упомянутые файлы и покажите соответствующие части.✓ Скопировано

claude-historian-mcp + memory-bank-mcp

Перенесите одноразовое исправление в долговременную память

Исправление из сеанса X выглядит несущим; добавьте его в Memory-bank/<project>/bugs.md.✓ Скопировано

claude-historian-mcp + codebase-memory

Обоснование текстовых попаданий историка в граф кода

Сеанс X касается fn retryBilling — показывает мне текущих вызывающих абонентов через память кодовой базы.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
search	query: str, scope: one-of (conversations\|errors\|plans\|config\|tasks\|sessions\|tools\|similar\|memories\|…), limit?: int	Найдите предыдущие разговоры, относящиеся к вашей текущей задаче.	0
inspect	session_id: str (full UUID or short prefix)	Получите удобочитаемый отчет об одном сеансе	0

Стоимость и лимиты

Во что обходится

Квота API: Нет — проверка локального файла
Токенов на вызов: Зависит от размера результата; кепка с лимитом
Деньги: Бесплатно
Совет: Используйте узкие рамки (ошибки, планы) вместо «разговоров», чтобы ответы были небольшими.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: Никаких учетных данных. Работает только с локальными файлами.

Исходящий трафик: Ничто не покидает вашу машину. Сервер MCP читает только ~/.claude/conversations/.

История разговоров может содержать секреты, которые вы вставили ранее. Вы несете ответственность за редактирование, прежде чем делиться результатами поиска.
Общие машины: арендатор, имеющий доступ к вашему домашнему каталогу, может читать все прошлые сеансы. Защищайте ~/.claude так же, как вы защищаете ~/.ssh.

Устранение неполадок

Частые ошибки и исправления

Нет результатов, даже если вы знаете, что разговор существует.

Попробуйтеscope='conversations' и расслабьте запрос; проверьте, что ~/.claude/conversations/ не пусто.

Проверить: ls ~/.claude/conversations/ | head

Проверка говорит, что сеанс не найден по короткому префиксу

Другая сессия начинается с того же префикса. Используйте больше символов.

Проверить: Grep session IDs: grep -r -l '<prefix>' ~/.claude/conversations/

Медленно на очень больших историях

Пройдите более узкую сферу и предел; инструмент сканирует по требованию, поэтому большие истории обходятся дороже за запрос.

Проверить: du -sh ~/.claude/conversations/

Альтернативы

Claude Historian в сравнении

Альтернатива	Когда использовать	Компромисс
memory-bank-mcp	Вам нужна тщательно подобранная память на уровне проекта, а не поиск по необработанной истории.	Должен быть заселен; не свободный поиск
codebase-memory	Вам нужен граф символов кода, а не поиск диалогов.	Другой слой
filesystem	Вы бы предпочли сами просматривать разговоры	Потеря оценки, нечеткого сопоставления и сводок сеансов

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills