इस प्रोजेक्ट के बारे में

ContextAtlas एक MCP सर्वर है जो Claude Code को किसी कोडबेस का पहले से गणना किया गया "atlas" देता है, ताकि आर्किटेक्चरल प्रश्नों का उत्तर कई grep और फ़ाइल-पढ़ने वाली कॉलों के बजाय एक ही संयुक्त संदर्भ बंडल से दिया जा सके। यह क्या करता है - इंडेक्स के समय यह ADRs, READMEs और डिज़ाइन दस्तावेज़ों, निर्यात किए गए सिंबल्स के docstrings, और फ़िल्टर किए गए git कमिट संदेशों से संरचित दावे निकालता है, और उन्हें विशिष्ट कोड सिंबल्स से जोड़ता है। - क्वेरी के समय यह प्रति सिंबल चार संकेतों को जोड़ता है: LSP संरचनात्मक डेटा (परिभाषा, संदर्भ, प्रकार, डायग्नोस्टिक्स), आर्किटेक्चरल इरादे के दावे, git इतिहास (हाल के कमिट, hot/cold, co-change), और टेस्ट संबंध। - तीन MCP टूल उपलब्ध हैं: get_symbol_context (किसी ज्ञात सिंबल के लिए पूरा बंडल, बहु-सिंबल मोड में 10 तक), find_by_intent (लोकल SQLite FTS5 में इंडेक्स किए गए दावा टेक्स्ट पर BM25 खोज), और impact_of_change (co-change और टेस्ट प्रभाव का उपयोग करके blast radius)। - क्वेरी समाधान लोकल है: SQLite लुकअप और लोकल लैंग्वेज-सर्वर कॉल, सामान्य उपयोग के दौरान कोई नेटवर्क ट्रैफ़िक या मॉडल कॉल नहीं। भाषा समर्थन TypeScript, Python, Go, Ruby और C# को लैंग्वेज सर्वर (typescript-language-server, Pyright, gopls, ruby-lsp, csharp-ls) के माध्यम से समर्थित किया जाता है, जो उपयोगकर्ता द्वारा इंस्टॉल किए जाने वाले peer dependencies हैं। Node.js 20+ आवश्यक है। दो सेटअप मार्ग - Skills मार्ग: पैकेज इंस्टॉल करें, init चलाएँ, फिर Claude Code के भीतर /generate-adrs, /index-atlas और /prime-atlas का उपयोग करें; किसी API key की आवश्यकता नहीं। - CLI मार्ग: इंस्टॉल करें, ANTHROPIC_API_KEY सेट करें, init, generate-adrs, index और doctor चलाएँ। जिन रेपो में पहले से docs/adr/ के अंतर्गत ADRs हैं, वे generate-adrs छोड़ सकते हैं, क्योंकि मौजूदा ADRs स्वतः निकाल लिए जाते हैं। कमिट किया गया atlas पैटर्न उत्पन्न atlas.json को कोड और ADRs के साथ रिपॉज़िटरी में कमिट करने के लिए बनाया गया है। रेपो क्लोन करने वाले साथी इसे सीधे लोकल कैश में आयात करते हैं और निष्कर्षण दोबारा नहीं चलाते, तथा योगदानकर्ता इसे तब पुनः उत्पन्न कर सकते हैं जब परिवर्तन आर्किटेक्चरल दावों को प्रभावित करें। जो टीमें इसे कमिट नहीं कर सकतीं, वे atlas.committed: false सेट कर सकती हैं और प्रत्येक डेवलपर अपना निष्कर्षण स्वयं चलाता है। गोपनीयता नोट्स इंडेक्स के समय, कॉन्फ़िगरेशन से मेल खाने वाली ADR/डॉक फ़ाइलें, निर्यात किए गए सिंबल्स का docstring टेक्स्ट, और फ़िल्टर किए गए कमिट संदेश Anthropic API को भेजे जाते हैं; सोर्स कोड, उन संदेशों से आगे का git इतिहास, LSP डेटा और रनटाइम क्वेरी सामग्री नहीं भेजी जाती। docs.include glob यदि सोर्स फ़ाइलों से मेल खाता है तो वे फ़ाइलें पूरी भेज दी जाएँगी। निष्कर्षण स्ट्रीम सीमित की जा सकती हैं (उदाहरण के लिए केवल ADRs तक)। सभी निकाले गए दावे और क्वेरी समाधान लोकल SQLite फ़ाइल में रहते हैं। रिपोर्ट किए गए बेंचमार्क README honojs/hono, encode/httpx और spf13/cobra पर एक बेंचमार्क सूट की रिपोर्ट करता है, जिसमें पूर्व-पंजीकृत प्रॉम्प्ट और ब्लाइंड ग्रेडिंग हैं, और आर्किटेक्चरल-इरादे वाले प्रॉम्प्ट पर 45-72% टोकन कमी तथा कुल मिलाकर hono संदर्भ रन में 39% कम टूल कॉल का उल्लेख करता है। यह गुणवत्ता में युग्मित अंतर (तथ्यात्मक सटीकता, hallucination, actionability, completeness) भी विश्वास अंतरालों के साथ रिपोर्ट करता है, और बताता है कि tie और trick प्रॉम्प्ट बकेट्स में ContextAtlas नेट-नेगेटिव दिखा, जिसे लेखक अपेक्षित बताते हैं। ये आँकड़े परियोजना के अपने बेंचमार्क रिपॉज़िटरी से आते हैं और इन्हें लेखक-रिपोर्टेड माना जाना चाहिए, स्वतंत्र रूप से सत्यापित नहीं। स्थिति और लाइसेंसिंग README बताता है कि v0.9.0 2026-05-16 को जारी हुआ और पैकेज अभी npm पर प्रकाशित नहीं है, इसलिए इंस्टॉल निर्देश इच्छित स्वरूप का वर्णन करते हैं। MIT लाइसेंस प्राप्त।