claude-lens

MCP-сервер, который даёт Claude Code поисковую память по всем прошлым сессиям.

Индексирует каждый JSONL-файл сессии Claude Code в базе данных SQLite с полнотекстовым поиском FTS5. Claude получает инструменты для поиска по разговорам, поиска прошлых вызовов инструментов, фильтрации по проекту или дате и поиска ошибок, которые он уже решал.

Как это работает

Claude Code хранит сессии в виде JSONL-файлов в ~/.claude/projects/. claude-lens анализирует их при запуске, создаёт поисковый индекс FTS5 и предоставляет 9 инструментов через MCP. Агентный цикл Claude сам решает, когда искать в своей истории — ручной вызов не требуется.

Это активное припоминание, а не пассивный RAG. Claude сам решает, что искать, читает результаты и может углубляться с помощью уточняющих запросов. Та же схема, что и у человека, пользующегося поисковиком: несколько точечных запросов лучше одного слепого извлечения.

Related MCP server: conversation-search

Инструменты

Установка

git clone https://github.com/jasonpaulmichaels/claude-lens.git
cd claude-lens
bash scripts/install.sh

Или вручную:

# Sync repo to runtime install location
rsync -a --exclude=node_modules --exclude=.git --exclude=test \
  ./ ~/.claude/mods/claude-lens/
cd ~/.claude/mods/claude-lens && npm install --omit=dev

# Register MCP server (user scope so it's available everywhere)
claude mcp add -s user claude-lens -- node ~/.claude/mods/claude-lens/src/index.js

install.sh делает это за вас. Репозиторий с исходным кодом остаётся отдельным от установки в рантайме — редактируйте исходный код и повторно запускайте install.sh для развёртывания.

Перезапустите Claude Code после установки. При первом запуске индексируются все сессии (это занимает несколько минут). Последующие запуски выполняются инкрементально (<5 секунд).

Использование

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

• «Над чем я работал на прошлой неделе?»

• «Как я исправил ошибку аутентификации в betterclaw?»

• «Найди сессию, где я настраивал туннель cloudflare»

• «Какую команду я запускал для пересборки модуля ядра?»

• «Покажи ошибки, с которыми я сталкивался при работе над listforge»

Требования

• Node.js 20+

• Claude Code с поддержкой MCP

Данные

• Сессии индексируются из: ~/.claude/projects/

• База данных хранится в: ~/.claude-lens/claude-lens.db

• Сессии субагентов пропускаются

• Вывод инструментов обрезается до 500 символов, чтобы база данных оставалась управляемой

• Инкрементальная индексация через отслеживание mtime файлов

Лицензия

MIT