Codebase Memory MCP : Exploration de code basée sur des graphes pour Claude Code

Un développeur a créé un serveur MCP appelé codebase-memory-mcp qui résout un problème courant avec Claude Code : l'utilisation inefficace des tokens lors de l'exploration de la structure d'une base de code. Au lieu de faire parcourir les fichiers un par un à Claude pour des questions comme "qu'est-ce qui appelle cette fonction ?" ou "trouver le code mort", cet outil construit un graphe de connaissances persistant de la base de code.

Comment cela fonctionne

Le serveur utilise Tree-sitter pour analyser 64 langages (dont Python, Go, JavaScript, TypeScript, Rust, Java et C++) dans un graphe basé sur SQLite qui capture les fonctions, classes, chaînes d'appels, routes HTTP et liens inter-services. Lorsque Claude Code pose des questions structurelles, il interroge ce graphe au lieu de parcourir les fichiers individuellement.

Améliorations des performances

Dans une comparaison, 5 questions structurelles ont consommé environ 412 000 tokens via l'exploration traditionnelle fichier par fichier contre seulement environ 3 400 tokens via les requêtes de graphe - une réduction de 120x. Le développeur rapporte des économies moyennes d'environ 20x moins de tokens en utilisation régulière, plus des gains de temps significatifs.

Fonctionnalités principales

• Support de 64 langages via l'analyse Tree-sitter
• Tracé du graphe d'appels : "qu'est-ce qui appelle ProcessOrder ?" renvoie la chaîne complète en <100ms
• Détection de code mort avec filtrage intelligent des points d'entrée
• Liaison HTTP inter-services (trouve les appels REST entre services)
• Langage de requête de type Cypher pour l'exploration ad-hoc
• Vue d'ensemble de l'architecture avec détection de communautés Louvain
• Architecture Decision Records qui persistent entre les sessions
• 14 outils MCP (fonctionne aussi avec Codex CLI, Cursor, Windsurf et autres intégrations)
• Mode CLI pour une utilisation directe en terminal sans client MCP

Configuration et utilisation

L'outil est un binaire Go unique sans Docker, bases de données externes ou clés API requises. L'installation se fait via codebase-memory-mcp install qui configure automatiquement Claude Code. Les utilisateurs disent simplement "Indexer ce projet" pour commencer, et le graphe se synchronise automatiquement lorsque les fichiers sont modifiés pour rester à jour.

Benchmarks et licence

Le développeur a réalisé des benchmarks sur 35 dépôts open source réels allant de 78 à 49 000 nœuds, y compris le noyau Linux. Le projet est open source sous licence MIT.