عن المشروع

ContextAtlas هو خادم MCP يزود Claude Code بـ "أطلس" محسوب مسبقاً لقاعدة التعليمات البرمجية، مما يسمح بالإجابة على الأسئلة المعمارية من حزمة سياق موحدة بدلاً من إجراء العديد من عمليات البحث وقراءة الملفات. ما الذي يقوم به: - في وقت الفهرسة، يستخرج مطالبات منظمة من ADRs، وملفات README، ومستندات التصميم، وسلاسل التوثيق للرموز المصدرة، ورسائل الالتزام (git commit) المفلترة، وربطها برموز برمجية محددة. - في وقت الاستعلام، يدمج أربع إشارات لكل رمز: بيانات هيكلية من LSP (التعريفات، المراجع، الأنواع، التشخيصات)، مطالبات النوايا المعمارية، سجل git (الالتزامات الأخيرة، التغييرات المشتركة)، وارتباطات الاختبار. - يوفر ثلاث أدوات MCP: get_symbol_context (حزمة كاملة لرمز معروف)، find_by_intent (بحث BM25 عبر نصوص المطالبات المفهرسة في SQLite FTS5)، و impact_of_change (نطاق التأثير باستخدام التغييرات المشتركة وتأثير الاختبار). - يتم حل الاستعلام محلياً: بحث في SQLite واستدعاءات خادم اللغة المحلي، دون حركة مرور شبكة أو استدعاءات نموذج أثناء الاستخدام العادي. دعم اللغات: يتم دعم TypeScript وPython وGo وRuby وC# من خلال خوادم اللغة (مثل typescript-language-server وPyright وgopls وغيرها)، وهي تبعيات يثبتها المستخدم. يتطلب Node.js 20+. مسارات الإعداد: - مسار المهارات: تثبيت الحزمة، تشغيل init، ثم استخدام الأوامر داخل Claude Code؛ لا حاجة لمفتاح API. - مسار CLI: تثبيت الحزمة، تعيين ANTHROPIC_API_KEY، تشغيل init، ثم توليد ADRs والفهرسة. المستودعات التي تحتوي بالفعل على ADRs تحت docs/adr/ يمكنها تخطي خطوة التوليد، حيث يتم استخراجها تلقائياً. نمط الأطلس الملتزم به: يُقصد بملف atlas.json المولد أن يتم الالتزام به في المستودع بجانب الكود وADRs. يقوم الزملاء الذين يستنسخون المستودع باستيراده مباشرة إلى ذاكرة تخزين مؤقت محلية دون إعادة الفهرسة. يمكن للفرق التي لا تستطيع الالتزام به ضبط atlas.committed: false ليقوم كل مطور بتشغيل الاستخراج الخاص به. ملاحظات الخصوصية: في وقت الفهرسة، يتم إرسال ملفات ADR/doc المطابقة للتكوين، ونصوص التوثيق للرموز المصدرة، ورسائل الالتزام المفلترة إلى واجهة برمجة تطبيقات Anthropic؛ بينما لا يتم إرسال الكود المصدري، أو سجل git الكامل، أو بيانات LSP. تظل جميع المطالبات المستخرجة وحل الاستعلام في ملف SQLite محلي. المعايير المذكورة: تشير وثائق المشروع إلى تحسينات في تقليل الرموز (tokens) بنسبة 45-72% في المطالبات المتعلقة بالنوايا المعمارية، وتقليل استدعاءات الأدوات بنسبة 39% في تشغيل مرجعي لـ Hono. هذه الأرقام تأتي من مستودع المعايير الخاص بالمشروع ويجب التعامل معها كبيانات أبلغ عنها المؤلفون. الحالة والترخيص: تم إصدار النسخة v0.9.0 في 16 مايو 2026، والحزمة مرخصة بموجب ترخيص MIT.