Skip to main content
Glama

claude-lens

Servidor MCP que le da a Claude Code una memoria consultable de todas las sesiones pasadas.

Indexa cada archivo JSONL de sesión de Claude Code en una base de datos SQLite con búsqueda de texto completo FTS5. Claude obtiene herramientas para buscar conversaciones, encontrar llamadas a herramientas anteriores, filtrar por proyecto o fecha y consultar errores que ya ha resuelto antes.

Cómo funciona

Claude Code almacena las sesiones como archivos JSONL en ~/.claude/projects/. claude-lens los analiza al iniciarse, crea un índice de búsqueda FTS5 y expone 9 herramientas a través de MCP. El bucle del agente de Claude decide cuándo buscar en su propio historial — no se necesita ninguna invocación manual.

Esto es recuerdo activo, no RAG pasivo. Claude decide qué buscar, lee los resultados y puede profundizar con consultas de seguimiento. El mismo patrón que un humano al usar un buscador — varias consultas específicas superan a una sola recuperación a ciegas.

Related MCP server: conversation-search

Herramientas

Herramienta

Qué hace

search_sessions

Búsqueda de texto completo en todos los mensajes de sesión

search_tool_calls

Busca comandos Bash pasados, ediciones de archivos y patrones de grep

get_session

Lee una transcripción completa de sesión

get_session_summary

Metadatos rápidos: proyecto, modelo, herramientas usadas, archivos modificados

filter_by_project

Lista sesiones de un proyecto específico

filter_by_date

Encuentra sesiones dentro de un rango de fechas

list_projects

Todos los proyectos con recuentos de sesiones

get_stats

Estadísticas generales del índice

search_errors

Encuentra errores anteriores de herramientas y cómo se resolvieron

Instalación

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

O manualmente:

# 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 hace esto por ti. El repositorio fuente se mantiene separado de la instalación en tiempo de ejecución — edita el código fuente y vuelve a ejecutar install.sh para desplegar.

Reinicia Claude Code después de instalar. El primer inicio indexa todas las sesiones (tarda unos minutos). Los inicios posteriores son incrementales (<5 segundos).

Uso

Usa Claude Code con normalidad. Cuando el contexto de sesiones pasadas pueda ayudar, Claude buscará automáticamente. También puedes preguntar directamente:

  • "¿En qué estaba trabajando la semana pasada?"

  • "¿Cómo arreglé el bug de autenticación en betterclaw?"

  • "Encuentra la sesión donde configuré el cloudflare tunnel"

  • "¿Qué comando ejecuté para reconstruir el módulo del kernel?"

  • "Muéstrame los errores que encontré mientras trabajaba en listforge"

Requisitos

  • Node.js 20+

  • Claude Code con soporte MCP

Datos

  • Sesiones indexadas desde: ~/.claude/projects/

  • Base de datos almacenada en: ~/.claude-lens/claude-lens.db

  • Las sesiones de subagentes se omiten

  • Las salidas de las herramientas se truncan a 500 caracteres para mantener la base de datos manejable

  • Indexación incremental mediante seguimiento de mtime de los archivos

Licencia

MIT

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • -
    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.
    -
  • 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
    -
  • 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