عن المشروع

codebase-memory-mcp هو محرك ذكاء كودي مصمم لخدمة وكلاء البرمجة عبر بروتوكول سياق النموذج (MCP). يقوم بتحليل الكود إلى رسم بياني معرفي دائم من الدوال، الفئات، سلاسل الاستدعاء، مسارات HTTP، والروابط عبر الخدمات، ثم يجيب على الاستعلامات الهيكلية. أبرز الميزات: - الفهرسة: تحليل AST بـ tree-sitter عبر 162 مخططاً مُضمَّناً في الملف الثنائي. يستخدم pipeline ذا تركيز على الذاكرة مع ضغط LZ4 وSQLite في الذاكرة ومطابقة Aho-Corasick. يُفهرس Linux kernel (28 مليون سطر، 75 ألف ملف) في 3 دقائق تقريباً. - LSP هجين: تنفيذ خفيف بالC لخوارزميات حل الأنواع لـ Python، TypeScript/JavaScript/JSX/TSX，PHP，C#، Go، C，C++، Java، Kotlin، Rust، Perl، مع دعم ربط المعاملات، استنتاج نوع الإرجاع، والتعويض العام. - سطح الاستعلام: 15 أداة MCP تشمل نظرة معمارية، تتبع رسم الاتصال، تحليل الأثر، اكتشاف الكود الميت، استعلامات تشبه Cypher، بحث دلالي، بحث نصي كامل BM25، وبحث كودي. يحقق استعلامات هيكلية أقل من مللي ثانية ويقلل الرموز مقارنة بالاستكشاف الفردي. - نموذج الرسم البياني: حواف من نوع CALLS, IMPORTS, DEFINES, IMPLEMENTS, INHERITS, HTTP_CALLS, EMITS, LISTENS_ON, DATA_FLOWS, SIMILAR_TO, SEMANTICALLY_RELATED. حواف CROSS_* تربط عبر المستودعات في نفس المخزن. - البنية التحتية ككود: Dockerfiles ومخططات Kubernetes وKustomize overlays تُفهرس كعُقَد مع إشارات متقاطعة. - التوزيع: ملف ثنائي واحد native لأنظمة macOS, Linux, Windows بدون أي runtime أو خدمة أو API key. متوفر أيضاً عبر npm, PyPI, Homebrew, Scoop, Winget, Chocolatey, AUR, go install. كل المعالجة محلية. - التشغيل: أمر install يكتشف ويُعدّل وكلاء البرمجة المدعومين تلقائياً. process تنسيق مشترك يدير watchs والخلفيات ومؤشرات الرسم البياني واختياري UI. يمكن ضبط auto-index وauto-watch. UI مرئي ثلاثي الأبعاد يعمل على localhost:9749. - مشاركة الفريق: يمكن نسخ Snapshot SQLite مضغوط zstd (.codebase-memory/graph.db.zst) وإرساله لفريق العمل بحيث يبنيون من الأثر ويشغلون فهرسة تزايدية بدلاً من كاملة. المشروع لا يدمج LLM؛ العميل MCP يعمل كطبقة ذكية تترجم الأسئلة الطبيعية إلى استعلامات بيانية. يذكر README ورقة بحثية (arXiv:2603.27277) تصف التصميم والأداء، ويعتمد ممارسات أمنية مثل المعالجة المحلية-only والتحقق من artifacts.