Claude Historian MCP — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Zwei Tools: „Suche“ (11 Bereiche) und „Inspektion“ (Sitzungszusammenfassung)
Liest aus ~/.claude/conversations/ – kein externer Dienst
TF-IDF + Fuzzy-Matching mit Workflow-Mustererkennung
Paralleler Projektscan; Es muss kein persistenter Index gepflegt werden
Sitzungs-IDs mit kurzem Präfix werden unterstützt

Live-Demo

In der Praxis

claude-historian-mcp.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-historian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-historian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-historian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-historian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-historian-mcp",
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-historian-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "claude-historian-mcp"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add claude-historian-mcp -- npx -y claude-historian-mcp

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: Claude Historian

Finden Sie heraus, wie Sie zuvor einen ähnlichen Fehler behoben haben

👤 Entwickler, die Claude Code über viele Sitzungen hinweg verwenden ⏱ ~5 min beginner

Wann einsetzen: Sie stoßen auf einen Fehler, der Ihnen bekannt vorkommt; Sie möchten sehen, was beim letzten Mal funktioniert hat.

Voraussetzungen

Claude Code mit vorhandenem Gesprächsverlauf — Standard: Der Verlauf befindet sich in ~/.claude/conversations/

Ablauf

Suchfehler

Durchsuchen Sie meinen Verlauf nach „ECONNREFUSED redis“ – Umfang: Fehler.✓ Kopiert

→ Rangliste früherer Sitzungen, in denen dieser Fehler aufgetreten ist
Untersuchen Sie den besten Treffer

Überprüfen Sie die Sitzung abc12345 – was wurde behoben?✓ Kopiert

→ Die Zusammenfassung nennt die Grundursache und den angewendeten Fix

Ergebnis: Ein konkreter Präzedenzfall in Sekundenschnelle, kein erneutes Debuggen von Grund auf.

Fallstricke

Der Zusammenfassung vertrauen, ohne die Sitzung zu lesen — Verwenden Sie inspect für die Zusammenfassung und öffnen Sie dann die Sitzungsdatei für die tatsächlichen Unterschiede

Kombinieren mit: filesystem

Rufen Sie einen früheren Implementierungsplan zur Wiederverwendung auf

👤 Jeder, der häufig Aufgaben mit Claude plant ⏱ ~10 min beginner

Wann einsetzen: Die neue Funktion sieht aus wie eine, die Sie vor Monaten geplant haben – Sie möchten das Skelett zurück.

Ablauf

Suchpläne

Suchbereich: Pläne für „Wiederholung von Hintergrundjobs mit exponentiellem Backoff“.✓ Kopiert

→ Zu den Treffern gehören die Planüberschriften und die Sitzungs-ID
Prüfen und anpassen

Untersuchen Sie den Top-Hit. Fassen Sie den Plan zusammen und passen Sie ihn für Postgres-gestützte Warteschlangen an.✓ Kopiert

→ Angepasster Plan in der gleichen Struktur wie das Original

Ergebnis: Wiederverwendetes Denken, ohne das Gerüst neu zu generieren.

Kombinieren mit: codebase-memory

Starten Sie eine neue Sitzung mit dem vorherigen Kontext

👤 Starke Claude-Code-Benutzer ⏱ ~10 min intermediate

Wann einsetzen: Sie beginnen einen neuen Chat über ein altes Projekt und möchten den Kontext nicht noch einmal erklären.

Ablauf

Suchen Sie nach Projekterwähnungen

Suchbereich: Sitzungen für „acme-api billing“, gruppiert nach Projekt.✓ Kopiert

→ Die relevantesten 3–5 Sitzungen für dieses Projekt
Auf Hydratation prüfen

Überprüfen Sie die Sitzung 7f3e2a10. Fassen Sie Architekturentscheidungen und bekannte Fehler zusammen.✓ Kopiert

→ Klare Zusammenfassung, die die neue Sitzung begründet

Ergebnis: Die neue Sitzung beginnt dort, wo die letzte nützliche Sitzung aufgehört hat.

Fallstricke

Zu viele Sitzungen gleichzeitig laden und im Kontext ertrinken — Erreichen der Top 5 nach Punktzahl; Verwenden Sie inspect nur das Beste

Kombinieren mit: memory-bank-mcp

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

claude-historian-mcp + filesystem

Öffnen Sie nach der Inspektion die referenzierten Dateien für die tatsächlichen Unterschiede

Überprüfen Sie Sitzung X. Öffnen Sie dann die genannten Dateien und zeigen Sie die relevanten Teile an.✓ Kopiert

claude-historian-mcp + memory-bank-mcp

Fördern Sie einen einmaligen Fix im dauerhaften Speicher

Der Fix aus Sitzung X sieht belastbar aus; Fügen Sie es zu „memory-bank/<project>/bugs.md“ hinzu.✓ Kopiert

claude-historian-mcp + codebase-memory

Erden Sie die Texttreffer des Historikers im Codediagramm

Sitzung X berührt fn retryBilling – zeigt mir aktuelle Anrufer über Codebase-Memory an.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
search	query: str, scope: one-of (conversations\|errors\|plans\|config\|tasks\|sessions\|tools\|similar\|memories\|…), limit?: int	Finden Sie frühere Gespräche, die sich auf Ihre aktuelle Aufgabe beziehen	0
inspect	session_id: str (full UUID or short prefix)	Erhalten Sie eine für Menschen lesbare Zusammenfassung einer einzelnen Sitzung	0

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Keine – lokaler Dateiscan
Tokens pro Aufruf: Hängt von der Ergebnisgröße ab; Kappe mit Limit
Kosten in €: Frei
Tipp: Verwenden Sie enge Bereiche (Fehler, Pläne) anstelle von „Gesprächen“, um die Antworten klein zu halten.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: Keine Anmeldeinformationen. Funktioniert nur mit lokalen Dateien.

Datenabfluss: Nichts verlässt Ihre Maschine. Der MCP-Server liest nur ~/.claude/conversations/.

Ihr Gesprächsverlauf kann Geheimnisse enthalten, die Sie zuvor eingefügt haben. Die Schwärzung liegt in Ihrer Verantwortung, bevor Sie Suchergebnisse weitergeben.
Gemeinsam genutzte Maschinen: Ein Mieter mit Zugriff auf Ihr Home-Verzeichnis kann alle vergangenen Sitzungen lesen. Schützen Sie ~/.claude so, wie Sie ~/.ssh schützen.

Fehlerbehebung

Häufige Fehler und Lösungen

Keine Ergebnisse, obwohl Sie wissen, dass die Konversation existiert

Versuchen Sie es mit „scope='conversations'“ und lockern Sie die Abfrage. Überprüfen Sie, ob ~/.claude/conversations/ nicht leer ist.

Prüfen: ls ~/.claude/conversations/ | head

Inspect sagt, dass die Sitzung für ein kurzes Präfix nicht gefunden wurde

Eine weitere Sitzung beginnt mit demselben Präfix. Verwenden Sie mehr Zeichen.

Prüfen: Grep session IDs: grep -r -l '<prefix>' ~/.claude/conversations/

Langsam bei sehr großen Historien

Verabschiedung eines engeren Geltungsbereichs und einer engeren Grenze; Das Tool scannt bei Bedarf, sodass große Historien mehr pro Abfrage kosten.

Prüfen: du -sh ~/.claude/conversations/

Alternativen

Claude Historian vs. andere

Alternative	Wann stattdessen	Kompromiss
memory-bank-mcp	Sie möchten einen kuratierten, projektbezogenen Speicher statt einer reinen Verlaufssuche	Muss ausgefüllt werden; kein Freiformabruf
codebase-memory	Sie möchten ein Symboldiagramm des Codes, keine Konversationssuche	Andere Schicht
filesystem	Sie möchten Gespräche lieber selbst mitlesen	Verlustbewertung, Fuzzy-Matching und Sitzungszusammenfassungen

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen