contextatlas

ContextAtlas est un serveur MCP qui fournit à Claude Code un « atlas » précalculé d’un codebase, afin que les questions architecturales puissent obtenir une réponse à partir d’un seul bundle de contexte fusionné plutôt que de nombreux appels grep et de lecture de fichiers. Rôle - Lors de l’indexation, il extrait des affirmations structurées des ADR, README et documents de conception, des docstrings des symboles exportés, et des messages de commit git filtrés, rattachées à des symboles de code spécifiques. - Lors de la requête, il fusionne quatre signaux par symbole : données structurelles LSP (définition, références, types, diagnostics), affirmations d’intention architecturale, historique git (commits récents, parties chaudes/froides, co-évolution) et associations avec les tests. - Trois outils MCP sont exposés : get_symbol_context (bundle complet pour un symbole connu, mode multi-symboles jusqu’à 10), find_by_intent (recherche BM25 dans le texte des affirmations indexées via SQLite FTS5 local), et impact_of_change (rayon d’impact basé sur la co-évolution et l’impact sur les tests). - La résolution des requêtes est locale : consultation SQLite et appels locaux au serveur de langage, sans trafic réseau ni appels de modèle en utilisation normale. Prise en charge des langages TypeScript, Python, Go, Ruby et C# sont pris en charge via des serveurs de langage (typescript-language-server, Pyright, gopls, ruby-lp, csharp-ls), qui sont des dépendances pairs installées par l’utilisateur. Node.js 20+ est requis. Deux parcours d’installation - Parcours Skills : installer le paquet, exécuter init, puis utiliser /generate-adrs, /index-atlas et /prime-atlas dans Claude Code ; aucune clé API n’est nécessaire. - Parcours CLI : installer, définir ANTHROPIC_API_KEY, exécuter init, generate-adrs, index et doctor. Les dépôts qui disposent déjà d’ADR sous docs/adr/ peuvent ignorer generate-adrs, car les ADR existants sont extraits automatiquement. Modèle d’atlas commité Le fichier atlas.json généré est destiné à être commité dans le dépôt aux côtés du code et des ADR. Les coéquipiers qui clonent le dépôt l’importent directement dans un cache local sans relancer l’extraction, et les contributeurs peuvent le régénérer lorsque des modifications affectent des affirmations architecturales. Les équipes qui ne peuvent pas le commiter peuvent définir atlas.committed: false et chaque développeur exécute sa propre extraction. Notes de confidentialité Lors de l’indexation, les fichiers ADR/doc correspondant à la configuration, le texte des docstrings des symboles exportés et les messages de commit filtrés sont envoyés à l’API Anthropic ; le code source, l’historique git au-delà de ces messages, les données LSP et le contenu des requêtes à l’exécution ne le sont pas. Un glob docs.include qui correspond à des fichiers source enverrait ces fichiers intégralement. Les flux d’extraction peuvent être limités (par exemple aux ADR uniquement). Toutes les affirmations extraites et la résolution des requêtes restent dans un fichier SQLite local. Benchmarks rapportés Le README rapporte une suite de benchmarks sur honojs/hono, encode/httpx et spf13/cobra avec des invites préenregistrées et une notation en aveugle, citant une réduction de 45 à 72 % des jetons pour les invites d’intention architecturale et une exécution de référence hono avec 39 % d’appels d’outils en moins au total. Il rapporte également des écarts de qualité appariés (exactitude factuelle, hallucination, caractère actionnable, complétude) avec intervalles de confiance, et indique que les catégories d’invites tie et trick ont montré ContextAtlas comme globalement négatif, ce que les auteurs présentent comme attendu. Ces chiffres proviennent du dépôt de benchmark du projet lui-même et doivent être considérés comme rapportés par les auteurs, et non vérifiés indépendamment. État et licence Le README indique que la v0.9.0 a été livrée le 2026-05-16 et que le paquet n’est pas encore publié sur npm ; les instructions d’installation décrivent donc la forme prévue. Licence MIT.