graphify-ts : Un serveur MCP local réduit les tokens de revue de PR de Claude Code de 63K à 8,7K

Si vous avez utilisé Claude Code sur une vraie codebase, vous avez vu le problème : chaque question déclenche 8 à 10 appels d'outils séquentiels (glob, grep, read, read, read) pour construire le contexte à partir de zéro. Les tokens d'entrée s'accumulent, la latence traîne, et l'agent redécouvre la même structure à chaque fois. graphify-ts est un serveur MCP gratuit et open source qui pré-indexe votre code dans un graphe de connaissances local, permettant à Claude de faire un seul appel retrieve.

Comment ça marche

Au moment de l'indexation, graphify-ts analyse votre code avec l'AST de tree-sitter, extrait les relations structurelles (fichiers, fonctions, classes, appels, imports), exécute la détection de communautés Louvain pour regrouper les modules connexes, indexe avec BM25, et réordonne optionnellement avec un modèle ONNX local. Le graphe résultant est servi via MCP stdio — entièrement local, aucune donnée ne quitte votre ordinateur. Le profil par défaut expose 6 outils pour maintenir un faible overhead de session (environ 5K tokens) ; vous pouvez opter pour la surface complète de 21 outils avec GRAPHIFY_TOOL_PROFILE=full.

Benchmarks vérifiables

Le dépôt inclut un script verify.sh qui redérive tous les nombres à partir de preuves validées. Les résultats mesurés sur une vraie codebase NestJS + Next.js en production (1 268 fichiers) avec Claude Opus 4.7 :

• Requête de code unique : 9 appels d'outils → 3, 615 190 tokens d'entrée → 233 508 (2,6× moins), latence de 96 s → 35 s (2,8× plus rapide). Les deux mesures proviennent du champ d'utilisation --output-format json de Claude.
• Revue de PR sur 36 fichiers : Les tokens de prompt sont passés de 63 024 à 8 690 (7,25× plus petits). Même reviewer, même diff, même profondeur de revue — les deux exécutions ont identifié les mêmes points chauds.
• Question multi-dépôts sur 3 dépôts : Prompt naïf estimé à ~1,5M tokens (ne tiendrait dans aucune fenêtre) contre 2 800 tokens avec graphify-ts. L'auteur note qu'il s'agit d'une estimation structurelle, pas d'un prompt réellement envoyé.

Installation et utilisation

npm install -g @mohammednagy/graphify-ts
cd votre-projet
graphify-ts generate .
graphify-ts claude install

Fonctionne aussi avec Cursor, Copilot, Gemini CLI, Aider, OpenCode via <agent> install.

Compromis à connaître

• Coût de démarrage à froid : La première session coûte environ 13% de plus que la baseline sans graphe à cause de l'overhead du schéma d'outils (~5K tokens). Les sessions multi-questions amortissent ce coût.
• Support linguistique : L'extraction profonde est meilleure sur JS/TS avec des passes spécifiques aux frameworks (Express, NestJS, Next.js, Redux Toolkit, React Router). Python/Ruby/Go/Java/Rust utilisent l'AST de tree-sitter standard. C/Kotlin/C#/Scala/PHP/Swift/Zig utilisent un extracteur structurel générique.
• Limites : Il s'agit d'une carte structurelle pour un agent, pas d'une base de données d'analyse de programme complète. Les routes fortement méta-programmées tombent sur l'AST de base.

L'auteur recherche activement des contre-exemples — des dépôts où le découpage structurel échoue. Sous licence MIT, nécessite Node 20+.