Skip to main content
Glama
deenesjakoruzh
sanchez314c

claude-lens

by sanchez314c
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

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

Инструменты

Инструмент

Что делает

search_sessions

Полнотекстовый поиск по всем сообщениям сессий

search_tool_calls

Поиск по прошлым командам Bash, изменениям файлов, grep-паттернам

get_session

Чтение полной стенограммы сессии

get_session_summary

Быстрые метаданные: проект, модель, использованные инструменты, затронутые файлы

filter_by_project

Список сессий для конкретного проекта

filter_by_date

Поиск сессий в диапазоне дат

list_projects

Все проекты с количеством сессий

get_stats

Общая статистика индекса

search_errors

Поиск прошлых ошибок инструментов и способов их решения

Установка

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

This server cannot be deployed

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Conversation Search MCP Server

    cordlesssteve
    -
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables comprehensive search and analysis of Claude Code conversation history using full-text search, optional semantic vector search, and conversation management tools. Provides fast SQLite-based indexing with role-based filtering, project organization, and hybrid search capabilities combining keyword and semantic matching.
    -

  • conversation-search

    gebeer
    F
    license
    Not graded
    quality
    D
    maintenance
    Full-text search over Claude Code conversation history using SQLite FTS5, exposing indexed transcripts as MCP tools for searching, browsing, and reading turns.
    4
    -

  • ccfolio

    Hippensteel
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables searching and browsing past Claude Code conversations directly from within an active Claude session, with full-text search and cost tracking.
    MIT