claude-memory-manager

claude-memory-manager

NyxToolsDevMIT
1 звёзд
Claude Memory Manager — это инструмент, который сохраняет контекст ваших сессий с Claude Code и делает его доступным в будущих сессиях. Каждый раз, когда вы обсуждаете архитектуру, выбираете библиотеку или настраиваете конфигурацию, эта информация теряется после закрытия сессии. Сервер решает эту проблему автоматически: он парсит логи завершённых сессий (формат JSONL), выделяет значимые события — решения, баги, настройки — оценивает их важность и сохраняет в локальную базу. Для поиска используется SQLite с расширением полнотекстового поиска FTS5 и семантический поиск на основе эмбеддингов. Это значит, что можно искать не только по ключевым словам, но и по смыслу. Например, запрос «как мы настраивали базу данных» найдёт все упоминания конфигурации базы, даже если точная формулировка была другой. Сервер работает в двух режимах: CLI для управления памятью и MCP-сервер для интеграции с Claude Desktop. Все данные остаются на вашем компьютере.
ClaudeDevelopmentSearch
Открыть на GitHub

Установка

uvx claude-memory-manager

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

Общее

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

Технологии

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

Описание

Возможности

  • Парсинг логов Claude Code (JSONL) и извлечение архитектурных решений, изменений кода, исправлений ошибок и настроек конфигурации.
  • Автоматическая оценка важности (importance scoring) каждого фрагмента — малозначимый шум отфильтровывается.
  • Сохранение в локальную базу SQLite с FTS5: полнотекстовый поиск по ключевым словам работает быстро и эффективно.
  • Семантический поиск через эмбеддинги: вы задаёте вопрос по смыслу, сервер находит подходящие memories, даже если слова не совпадают.
  • Гибридный поиск, объединяющий семантическое сходство и keyword matching — высокая точность на разных типах запросов.
  • Фильтрация по проекту (--project) и категории (--category, например config или architectural).
  • Генерация контекстной сводки по проекту: команда claude-memory context выводит ключевые факты с учётом лимита токенов (--max-tokens).
  • Автоматическая индексация новых сессий в реальном времени (режим --watch): сервер отслеживает появление новых логов и сразу добавляет их в базу.
  • Просмотр всех проиндексированных проектов (claude-memory context без аргументов).
  • Интеграция с Claude Desktop через MCP-протокол (stdio): контекст подгружается прямо в диалог.
  • Полностью локальная работа: данные не покидают ваш компьютер (для эмбеддингов можно использовать локальную модель).

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

1. Установка

Установите пакет:

pip install claude-memory-manager

Или через uvx (одноразовый запуск):

uvx claude-memory-manager

Для локальных эмбеддингов без ключа API используйте:

pip install claude-memory-manager[local]

2. Инициализация базы и загрузка логов


Выполните в терминале:


claude-memory init
claude-memory ingest

Первая команда создаёт базу данных и конфигурационный файл. Вторая — сканирует папку ~/.claude/projects/ и извлекает memories из всех доступных сессий. Можно указать другой путь: claude-memory ingest /path/to/sessions.

3. Настройка MCP-сервера для Claude Desktop


Добавьте в файл конфигурации Claude Desktop (claude_desktop_config.json) следующий объект в раздел mcpServers:


{
"mcpServers": {
"claude-memory": {
"command": "claude-memory-mcp",
"args": []
}
}
}

4. Перезапустите Claude Desktop — сервер автоматически запустится и будет доступен для запросов.

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

В диалоге с Claude, подключённым к MCP-серверу, задавайте вопросы о прошлых сессиях:

  • «Найди в памяти, как мы настраивали CORS в проекте myapp. Какой домен мы добавляли?»
  • «Покажи контекстную сводку по проекту /home/user/projects/myapp — какие архитектурные решения были приняты, какие библиотеки использованы.»
  • «Вспомни, как мы исправляли ошибку подключения к Redis. Причина была в неверном порту?»
  • «Найди все записи, связанные с конфигурацией TypeScript, за последнюю неделю.»

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

  • Язык: Python
  • Транспорт: stdio (MCP-протокол)
  • Хранилище: SQLite с FTS5
  • Семантический поиск: эмбеддинги (локальная модель или через API)
  • Лицензия: MIT
  • Совместимость: Claude Desktop, Claude Code, любые MCP-клиенты, поддерживающие stdio
  • Режимы работы: CLI, MCP-сервер, автоматический watch-режим

Поделиться