Code-Graph-MCP : Le serveur MCP open source réduit l'utilisation de tokens de code par Claude de 40 à 60 %

code-graph-mcp est un serveur MCP open source qui indexe les bases de code dans un graphe de connaissances AST pour réduire l'utilisation des tokens de Claude Code. Au lieu que Claude effectue de multiples appels grep/read/glob pour comprendre la structure du code, il interroge le graphe pour obtenir des réponses structurées en appels uniques.

Comment ça marche

L'outil analyse le code avec Tree-sitter, extrait les symboles (fonctions, classes, types, interfaces) et leurs relations (appels, imports, héritage, exports, liaisons de routes HTTP), puis stocke le tout dans SQLite avec la recherche en texte intégral FTS5 et sqlite-vec pour la similarité vectorielle. Il prend en charge 10 langages : TypeScript, JavaScript, Go, Python, Rust, Java, C, C++, HTML et CSS.

Outils principaux

• project_map — Aperçu complet de l'architecture en un seul appel (modules, dépendances, fonctions critiques, points d'entrée)
• semantic_code_search — Recherche hybride combinant BM25 + similarité vectorielle avec fusion RRF
• get_call_graph — Suivre les appelants/appelés avec des CTE récursifs
• impact_analysis — Voir tout ce qui dépend d'une fonction avant de la modifier
• trace_http_chain — Suivre les routes HTTP du gestionnaire à l'appel DB (prend en charge Express, Flask/FastAPI, Go)
• module_overview, dependency_graph, find_similar_code, get_ast_node — Fonctions supplémentaires de la boîte à outils

Résultats d'efficacité

Sur un projet Rust de 33 fichiers :

• Compréhension de l'architecture du projet : Réduction de 5-8 appels d'outils à 1 appel
• Traçage d'une chaîne d'appels à 2 niveaux : Réduction de 8-15 appels à 1 appel
• Analyse d'impact pré-modification : Réduction de 10-20+ appels à 1 appel
• Trouver une fonction par concept : Réduction de 3-5 appels à 1 appel

Globalement : ~80 % d'appels d'outils en moins par tâche de navigation, ~95 % de code source en moins déversé dans le contexte, et des économies de 40 à 60 % sur les tokens de session totale.

Détails techniques

L'indexation incrémentielle utilise un arbre de Merkle BLAKE3 pour suivre les hachages de contenu — seuls les fichiers modifiés sont ré-analysés. Les sous-arbres de répertoires inchangés sont entièrement ignorés via un cache mtime. Lorsqu'une signature de fonction change, la propagation des modifications régénère automatiquement le contexte pour tous les appelants en aval.

L'outil n'a aucune dépendance externe — c'est un seul binaire de 19 Mo avec SQLite intégré et sqlite-vec inclus. Aucun Docker, API cloud ou serveur de base de données requis. Les embeddings locaux optionnels utilisent un modèle d'embedding basé sur Candle, conditionné par fonctionnalité pour pouvoir être compilé sans si la recherche vectorielle n'est pas nécessaire.

Installation

Fonctionne avec Claude Code, Cursor, Windsurf ou tout client MCP.

Plugin Claude Code (recommandé) :

/plugin marketplace add sdsrss/code-graph-mcp
/plugin install code-graph-mcp

Cela inclut le serveur MCP plus les commandes slash (/understand, /trace, /impact), les hooks d'auto-indexation (ré-indexe à chaque modification de fichier), l'affichage d'état StatusLine et les mises à jour automatiques.

Pour tout client MCP :

npx -y @sdsrs/code-graph

Ou ajoutez à votre configuration MCP :

{
  "mcpServers": {
    "code-graph": {
      "command": "npx",
      "args": ["-y", "@sdsrs/code-graph"]
    }
  }
}

Quand ne pas l'utiliser

grep reste meilleur pour la recherche exacte de chaînes/constantes. Si vous devez trouver chaque occurrence de TODO ou un code d'erreur spécifique, utilisez grep. code-graph-mcp excelle lorsque vous devez comprendre la structure, les relations et l'architecture du code.