Claude Historian MCP — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Deux outils : "rechercher" (11 portées) et "inspecter" (résumé de la session)
Lit depuis ~/.claude/conversations/ — aucun service externe
TF-IDF + correspondance floue avec détection de modèles de flux de travail
Analyse de projet parallèle ; pas d'index persistant à maintenir
ID de session à préfixe court pris en charge

Démo en direct

Aperçu en pratique

claude-historian-mcp.replay ▶ prêt

0/0

Installer

Choisissez votre 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"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Claude Historian

Découvrez comment vous avez corrigé un bug similaire auparavant

👤 Développeurs qui utilisent Claude Code sur de nombreuses sessions ⏱ ~5 min beginner

Quand l'utiliser : Vous rencontrez une erreur qui vous semble familière ; vous voulez voir ce qui a fonctionné la dernière fois.

Prérequis

Claude Code avec historique des conversations existant — Par défaut : l'historique se trouve dans ~/.claude/conversations/

Déroulement

Erreurs de recherche

Recherchez dans mon historique « ECONNREFUSED redis » — portée : erreurs.✓ Copié

→ Liste classée des sessions précédentes où cette erreur est survenue
Inspectez le meilleur coup

Inspectez la session abc12345 : quel a été le correctif ?✓ Copié

→ Le résumé nomme la cause première et le correctif appliqué

Résultat : Un précédent concret en quelques secondes, pas un re-débogage à partir de zéro.

Pièges

Faire confiance au résumé sans lire la séance — Utilisez inspect pour le résumé, puis ouvrez le fichier de session pour les différences réelles

Combiner avec : filesystem

Récupérez un plan de mise en œuvre antérieur pour le réutiliser

👤 Toute personne planifiant fréquemment des tâches avec Claude ⏱ ~10 min beginner

Quand l'utiliser : La nouvelle fonctionnalité ressemble à celle que vous aviez planifiée il y a des mois : vous voulez récupérer le squelette.

Déroulement

Plans de recherche

Portée de la recherche : plans, pour « nouvelle tentative de tâche en arrière-plan avec interruption exponentielle ».✓ Copié

→ Les accès incluent les en-têtes du plan et l'ID de session
Inspecter et adapter

Inspectez le coup haut ; résumez le plan et adaptez-le aux files d'attente sauvegardées par Postgres.✓ Copié

→ Plan adapté dans la même structure que l'original

Résultat : Pensée réutilisée sans régénérer l’échafaudage.

Combiner avec : codebase-memory

Démarrez à chaud une nouvelle session avec le contexte passé

👤 Gros utilisateurs de Claude Code ⏱ ~10 min intermediate

Quand l'utiliser : Vous démarrez une nouvelle discussion sur un ancien projet et vous ne souhaitez pas réexpliquer le contexte.

Déroulement

Rechercher des mentions de projets

Portée de la recherche : sessions pour « facturation acme-api », regroupées par projet.✓ Copié

→ Les 3 à 5 sessions les plus pertinentes pour ce projet
Inspecter pour hydrater

Inspectez la session 7f3e2a10. Résumez les décisions architecturales et les bugs connus.✓ Copié

→ Un résumé clair qui fonde la nouvelle session

Résultat : La nouvelle session reprend là où la dernière utile s'est arrêtée.

Pièges

Charger trop de sessions à la fois et se noyer dans le contexte — Plafond au top 5 par score ; utilisez inspecter uniquement le meilleur

Combiner avec : memory-bank-mcp

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

claude-historian-mcp + filesystem

Après inspection, ouvrez les fichiers référencés pour les différences réelles

Inspectez la session X. Ensuite, ouvrez les fichiers mentionnés et affichez les parties pertinentes.✓ Copié

claude-historian-mcp + memory-bank-mcp

Transformez une solution ponctuelle en mémoire durable

Le correctif de la session X semble porteur ; ajoutez-le à memory-bank/<project>/bugs.md.✓ Copié

claude-historian-mcp + codebase-memory

Fondez les résultats du texte de l'historien dans le graphique de code

La session X touche fn retryBilling - montre-moi les appelants actuels via la mémoire de base de code.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
search	query: str, scope: one-of (conversations\|errors\|plans\|config\|tasks\|sessions\|tools\|similar\|memories\|…), limit?: int	Rechercher des conversations antérieures liées à votre tâche actuelle	0
inspect	session_id: str (full UUID or short prefix)	Obtenez un récapitulatif lisible par l'homme d'une seule session	0

Coût et limites

Coût d'exécution

Quota d'API: Aucun : analyse des fichiers locaux
Tokens par appel: Cela dépend de la taille du résultat ; plafond avec limite
Monétaire: Gratuite
Astuce: Utilisez des portées étroites (erreurs, plans) au lieu de « conversations » pour limiter les réponses.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Aucune information d'identification. Fonctionne uniquement sur les fichiers locaux.

Sortie de données : Rien ne quitte votre machine. Le serveur MCP lit uniquement ~/.claude/conversations/.

L'historique de vos conversations peut contenir des secrets que vous avez collés précédemment. La rédaction relève de votre responsabilité avant de partager les résultats de la recherche.
Machines partagées : un locataire ayant accès à votre répertoire personnel peut lire toutes les sessions passées. Protégez ~/.claude comme vous protégez ~/.ssh.

Dépannage

Erreurs courantes et correctifs

Aucun résultat même si vous savez que la conversation existe

Essayez scope='conversations' et assouplissez la requête ; vérifiez que ~/.claude/conversations/ n'est pas vide.

Vérifier : ls ~/.claude/conversations/ | head

Inspecter indique que la session est introuvable pour un préfixe court

Une autre session commence avec le même préfixe. Utilisez plus de caractères.

Vérifier : Grep session IDs: grep -r -l '<prefix>' ~/.claude/conversations/

Lent sur les très gros historiques

Adopter une portée et une limite plus étroites ; l'outil analyse à la demande, de sorte que les historiques volumineux coûtent plus cher par requête.

Vérifier : du -sh ~/.claude/conversations/

Alternatives

Claude Historian vs autres

Alternative	Quand l'utiliser	Compromis
memory-bank-mcp	Vous voulez une mémoire organisée et à l'échelle du projet plutôt qu'une recherche brute de l'historique	Doit être renseigné ; pas de récupération de forme libre
codebase-memory	Vous voulez un graphique de symboles de code, pas une recherche de conversation	Couche différente
filesystem	Vous préférez participer vous-même aux conversations	Perdre le score, la correspondance floue et les résumés de session

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills