Claude Replay

Claude Replay

constripacityMIT
1 звёзд
Claude Replay — это слой наблюдаемости для Claude Code. Встроенные команды --continue и /rewind восстанавливают текущую сессию, но не дают доступа к истории. Claude Replay решает задачу, которую они не закрывают: он пассивно записывает каждую сессию в локальную базу SQLite. Запись происходит через хуки PreToolUse, PostToolUse и Stop. Вы можете искать по всем проектам, анализировать метрики, сравнивать сессии и экспортировать их. Данные не покидают вашу машину — всё хранится в каталоге ~/.claude-replay.
Подключение

Подключить Claude Replay

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

Куда подключить

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Клиент запускает MCP-сервер как локальный процесс.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "claude-replay": {
      "command": "uvx",
      "args": [
        "claude-replay"
      ]
    }
  }
}

Сгенерировано из существующей команды запуска. Желательно сверить с README.

Инструкция собрана из данных карточки и пока не отмечена как проверенная редакцией. Сверьте команду с README источника и не передавайте лишние права или секреты.

Как оценить Claude Replay

Claude Replay относится к Claude, Разработка, Поиск. Ниже собраны проверяемые признаки, по которым его можно сравнить с другими серверами каталога.

Происхождение
Проект сообщества
Лицензия
MIT
Реализация
Python
Транспорт
stdio

Что проверить перед выбором

  • Изучите README, открытые issues и историю последних изменений в репозитории.
  • Проверьте команду установки и зависимости перед запуском в рабочем окружении.
  • Ограничьте доступ MCP-сервера только нужными файлами, API и переменными окружения.

Карточка отредактирована 08.08.2026.

Автоматическая проверка источника ещё не выполнена. Внешних источников в карточке: 1.

Характеристики

Общее

  • СтатусСообщество
  • Разработчикconstripacity
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

Сервер даёт набор инструментов для работы с историей сессий:

  • Полнотекстовый поиск по всем записанным сессиям Claude Code.
  • Детальная статистика по каждой сессии: количество шагов, затраченные токены и время.
  • Классификация причин завершения сессии (death-cause): ошибка, отмена пользователем или лимит токенов.
  • Сравнение двух сессий (diff) с наглядной разницей в контексте и цепочке действий.
  • Экспорт любой сессии в чистый HTML, JSON или Markdown.
  • Добавление тегов к сессиям для удобной каталогизации.
  • Добавление пользовательских заметок к сессиям.
  • Фильтрация сессий по проекту, дате, статусу и тегам.
  • Веб-дашборд на порту :8766 для визуализации таймлайна всех сессий.
  • Терминальный интерфейс (TUI) для быстрой навигации без выхода из терминала.
  • Восстановление (resume) произвольной сессии по чекпоинту.

Как подключить

Убедитесь, что у вас установлен Python 3.10 или новее.

Установите сервер через uvx:

uvx claude-replay

Добавьте конфигурацию в файл настроек вашего MCP-клиента (например, claude_desktop_config.json):

{ "mcpServers": { "claude-replay": { "command": "uvx", "args": ["claude-replay"] } } }

Перезапустите клиент. Сервер запустится автоматически при старте Claude Code или Claude Desktop. Все новые сессии начнут записываться в ~/.claude-replay/sessions.db.

Примеры запросов

  • «Найди все сессии за вчера, где упоминалась интеграция с PostgreSQL.»
  • «Покажи причину завершения последней сессии — она упала с ошибкой или я сам её закрыл?»
  • «Сравни сессию #10 и сессию #11. В чём разница в решениях?»
  • «Экспортируй сессию по работе над проектом frontend-v2 в формат Markdown.»
  • «Открой веб-дашборд Replay на порту 8766.»

Технические детали

  • Архитектура: пассивные хуки пишут в SQLite, MCP-инструменты и дашборд читают из неё.
  • Язык: Python 3.10+
  • Транспорт: stdio
  • Лицензия: MIT
  • База данных: SQLite (хранится в ~/.claude-replay/sessions.db)
  • Совместимость: Claude Desktop, Claude Code (CLI), любой MCP-клиент
  • Установка: uvx claude-replay

Вопросы и ответы

Claude Replay — это слой наблюдаемости для Claude Code. Встроенные команды --continue и /rewind восстанавливают текущую сессию, но не дают доступа к истории. Claude Replay решает задачу, которую они не закрывают: он пассивно записывает каждую сессию в локальную базу SQLite. Запись происходит через хуки PreToolUse, PostToolUse и Stop. Вы можете искать по всем проектам, анализировать метрики, сравнивать сессии и экспортировать их. Данные не покидают вашу машину — всё хранится в каталоге ~/.claude-replay.

Claude Replay не отмечен в каталоге как официальный MCP-сервер. Перед установкой проверьте владельца репозитория, лицензию и запрашиваемые разрешения.

В карточке разработчиком указан constripacity.

В карточке перечислены транспорты: stdio.

В карточке приведена команда установки или запуска: uvx claude-replay. Перед выполнением проверьте источник пакета и требования проекта.

Для проекта указана лицензия MIT. Условия использования нужно сверять с файлом лицензии исходного репозитория.

В карточке указаны языки реализации: Python.

MCP-сервер связан в каталоге с карточкой сервиса claude-code.

Поделиться