claude-lens
claude-lens
MCP-Server, der Claude Code ein durchsuchbares Gedächtnis über alle vergangenen Sitzungen verleiht.
Indiziert jede Sitzungs-JSONL-Datei von Claude Code in einer SQLite-Datenbank mit FTS5-Volltextsuche. Claude erhält Tools, um Unterhaltungen zu durchsuchen, vergangene Tool-Aufrufe zu finden, nach Projekt oder Datum zu filtern und Fehler nachzuschlagen, die es bereits gelöst hat.
So funktioniert es
Claude Code speichert Sitzungen als JSONL-Dateien in ~/.claude/projects/. claude-lens parst diese beim Start, erstellt einen FTS5-Suchindex und stellt über MCP 9 Tools bereit. Claudes Agenten-Loop entscheidet, wann die eigene Historie durchsucht wird — kein manueller Aufruf nötig.
Das ist aktives Erinnern, kein passives RAG. Claude entscheidet, wonach gesucht wird, liest die Ergebnisse und kann mit Folgeabfragen tiefer gehen. Dasselbe Muster wie bei einem Menschen, der eine Suchmaschine benutzt — mehrere gezielte Abfragen schlagen einen einzigen blinden Abruf.
Related MCP server: conversation-search
Tools
Tool | Was es tut |
| Volltextsuche über alle Sitzungsnachrichten |
| Suche nach vergangenen Bash-Befehlen, Dateibearbeitungen, grep-Mustern |
| Ein vollständiges Sitzungsprotokoll lesen |
| Kurze Metadaten: Projekt, Modell, verwendete Tools, berührte Dateien |
| Sitzungen für ein bestimmtes Projekt auflisten |
| Sitzungen innerhalb eines Datumsbereichs finden |
| Alle Projekte mit Sitzungsanzahl |
| Allgemeine Indexstatistiken |
| Vergangene Tool-Fehler finden und wie sie gelöst wurden |
Installation
git clone https://github.com/jasonpaulmichaels/claude-lens.git
cd claude-lens
bash scripts/install.shOder manuell:
# 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.jsinstall.sh erledigt das für dich. Das Quell-Repository bleibt von der Laufzeitinstallation getrennt — bearbeite den Quellcode und führe install.sh erneut aus, um die Änderungen bereitzustellen.
Starte Claude Code nach der Installation neu. Beim ersten Start werden alle Sitzungen indiziert (das dauert ein paar Minuten). Folgestarts sind inkrementell (<5 Sekunden).
Nutzung
Nutze Claude Code einfach ganz normal. Wenn Kontext aus vergangenen Sitzungen hilfreich wäre, durchsucht Claude automatisch den Verlauf. Du kannst auch direkt fragen:
"Woran habe ich letzte Woche gearbeitet?"
"Wie habe ich den Auth-Bug in betterclaw behoben?"
"Finde die Sitzung, in der ich den cloudflare tunnel eingerichtet habe."
"Welchen Befehl habe ich ausgeführt, um das Kernel-Modul neu zu bauen?"
"Zeig mir Fehler, auf die ich bei der Arbeit an listforge gestoßen bin."
Anforderungen
Node.js 20+
Claude Code mit MCP-Unterstützung
Daten
Indizierte Sitzungen aus:
~/.claude/projects/Datenbank gespeichert unter:
~/.claude-lens/claude-lens.dbSubagent-Sitzungen werden übersprungen
Tool-Ausgaben werden auf 500 Zeichen gekürzt, um die Datenbank handhabbar zu halten
Inkrementelle Indizierung durch Nachverfolgung der Datei-mtime
Lizenz
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Project memory, semantic code search, and grounded agent context.
Shared memory for coding agents. Stop re-explaining your codebase every session.
Search indexed code, trace dependencies, assess change impact, and recall repository memory.
- SeturosOAuthcom.seturos
Shared work memory for Claude Code, Codex, Cursor and chat, scoped to each repository.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceEnables 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.-
- FlicenseNot gradedqualityDmaintenanceFull-text search over Claude Code conversation history using SQLite FTS5, exposing indexed transcripts as MCP tools for searching, browsing, and reading turns.4-
- AlicenseAqualityDmaintenanceEnables Claude Code to search, browse, and read its own past conversation history across all projects using BM25 keyword search.116 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables searching and browsing past Claude Code conversations directly from within an active Claude session, with full-text search and cost tracking.MIT