تطلب من وكيل البرمجة أن يخبرك «من يستدعي هذه الدالة؟»، فيعيد قراءة أربعين ملفًا ويستهلك توكنات مع كل سؤال. من هذه النقطة ينطلق مشروع codebase-memory-mcp: يحتفظ بخريطة للشيفرة بدل أن يُجبر الوكيل على بنائها من جديد في كل مرة. في هذا المقال ننظر إلى codebase-memory-mcp خادم MCP بوصفه مكوّنًا يجب الترخيص له وتثبيته ومراقبته. المستودع هو DeusData/codebase-memory-mcp.
أبدأ من ثلاثة قرارات تشغيلية بدل جرد الميزات: ماذا تعطي الوكيل بدل الملفات الخام، وما الذي تسمح للمثبّت بكتابته على الجهاز، وكيف تتحقق من أن الفائدة موجودة عندك فعلًا.
توضيح للمنهج: لم يقم span.observer بتثبيت هذا المشروع ولا بتشغيله. المعلومات مأخوذة من README ومن server.json ومن ملفات المستودع، وقد قرأتها في 11 نوفمبر 2026. آخر commit قرأته يعود إلى اليوم نفسه، ويذكر server.json الإصدار 0.12.1. لم أتمكن من إعادة قراءة عدد النجوم من المصدر، لذلك لا أذكره. اللقطات مأخوذة من المستودع المرخّص برخصة MIT.
codebase-memory-mcp خادم MCP: خريطة للشيفرة لا ذاكرة للمحادثات
كلمة «ذاكرة» مضلِّلة. لا شيء هنا يتذكر حواراتك مع الوكيل: المشروع يفهرس الشيفرة والتوثيق وملفات البنية التحتية في رسم معرفي محلي. أما ذاكرة المحادثات فانظر https://span.observer/ar/claude-mem-persistent-memory-agents-ar/ أو https://span.observer/ar/ai-memory-coding-agent-memory-rust-ar/. موضوعنا هنا البنية: الدوال والاستدعاءات والمسارات والاعتماديات.
بحسب README، يعلن المشروع ما يلي:
- رخصة MIT وواجهة خلفية أصلية مكتوبة بلغة C، دون Docker ودون بيئة لغة تحتاج إلى تثبيت؛
- دعم 163 لغة وصيغة، مع تحليل إضافي للأنواع («Hybrid LSP») لبعضها؛
- 17 أداة MCP، منها
search_graphوtrace_pathوdetect_changesوget_architecture؛ - فهرسة واستعلامات لا تحتاج إلى خدمة مستضافة ولا إلى مفتاح API؛
- 46 تكاملًا مع الوكلاء، تلقائيًا أو بشروط، يضبطها المثبّت.
لا تحتوي الواجهة الخلفية على أي نموذج لغوي. بحسب README، عميل MCP لديك هو الذي يحوّل السؤال إلى استدعاءات أدوات: يستدعي الوكيل مثلًا trace_path بالاتجاه «inbound»، فيستعلم الخادم عن الرسم، ثم يصوغ الوكيل الجواب.
القرار الأول: ماذا تعطي الوكيل بدل الملفات؟
جواب المشروع في جملة واحدة: استعلامات موجّهة على رسم، بنتائج مقسّمة إلى صفحات ومضغوطة. الوكيل الذي يبحث عن مستدعي دالة لا يحتاج إلى محتوى كل ملف، بل إلى قائمة المستدعين ومساراتهم، ومقطع من الشيفرة عند الحاجة.
تنقسم الأدوات إلى عائلتين. للفهرسة: index_repository وlist_projects وindex_status وcheck_index_coverage. وللاستعلام: بحث بنيوي ودلالي، وتتبّع الاستدعاءات، وCypher للقراءة فقط، ومقاطع الشيفرة، ومخطط الملف، وdetect_changes الذي يربط diff في git بالرموز المتأثرة. ينصح README بتشغيل get_graph_schema أولًا.
نقطة تشغيلية مهمة في المستودعات الكبيرة: قد تتجاوز الفهرسة المتزامنة المهلة التي يمنحها العميل لاستدعاء أداة. عندها يوصي README بالوضع async: true ثم الاستعلام عن التقدم بـ status: true حتى الوصول إلى succeeded أو failed أو cancelled.
يقدّم المشروع أيضًا واجهة مرئية تجريبية هي CBM Lens (الإصدار 0.0.1). تعرض اللقطة الأولى عرض «Architecture» للمستودع نفسه: تتحول المجلدات إلى منصات والملفات إلى كتل. وتعرض الثانية قارئ المصدر، مع أثر الملف ورسم اعتمادياته على اليمين.


القرار الثاني: ما الذي تسمح للمثبّت بكتابته؟
التثبيت سطر واحد، لكنه يستحق وقفة. في macOS وLinux يقترح README تنزيل install.sh من الفرع الرئيسي وتنفيذه. وفي Windows يطلب تنزيل install.ps1 ومراجعته («optional but recommended») ثم رفع الحظر عنه وتنفيذه. اقرأ السكربت قبل تنفيذه، حتى على Linux: إنها العادة نفسها مع أي مثبّت يكتب في ملفات إعداداتك.
فالأمر install لا يكتفي بوضع ملف تنفيذي. إنه يكتشف عملاءك ويضيف إعداد MCP وتعليمات و«skills» وملفات تعريف وكلاء بأسماء Scout وVerify وAuditor، إضافة إلى hooks. بحسب README، تضيف هذه الـ hooks سياقًا دون أن تستبدل الأداة المستدعاة أو تعطّلها («context-only and fail-open»). وهي مفعّلة افتراضيًا: الخيار install --no-hooks يزيلها، والأمر config get install_hooks يعرض الاختيار الحالي.

إعدادات أخرى تُحسم قبل تعميم الاستخدام:
- الخيار
auto_indexمعطّل افتراضيًا. عند تفعيله يفهرس كل مشروع جديد عند أول اتصال، ضمن حدauto_index_limit. - الخيار
auto_watchمفعّل افتراضيًا: يُراقَب المشروع المفهرس من جديد ما دامت جلسة تملكه. ومعdaemon startتستمر المراقبة بعد انتهاء الجلسة. - تُحفظ الفهارس في
~/.cache/codebase-memory-mcp/داخل قواعد SQLite. يحتوي الفهرس على بنية شيفرتك، فعامل هذا المجلد كما تعامل الشيفرة نفسها. - يغيّر
CBM_CACHE_DIRموقع المجلد، ويحدّCBM_WORKERSوCBM_MEM_BUDGET_MBمن التوازي والذاكرة، وهو مفيد داخل حاوية.
أما سلسلة التوريد، فيصف README ملفات تنفيذية مفحوصة عبر VirusTotal، ومصدرًا موثّقًا بمستوى SLSA 3، وتواقيع Sigstore cosign، ومجاميع SHA-256 تتحقق منها سكربتات التثبيت. ويذكر أن Microsoft Defender قد يُصدر إنذارًا كاذبًا. هذه ادعاءات المشروع: الأمر gh attestation verify المذكور في README يتيح لك التحقق من المصدر بنفسك. ولتحديد ما يستطيع خادم MCP فعله على جهاز، اقرأ https://span.observer/ar/secure-mcp-server-ar/ وhttps://span.observer/ar/audit-mcp-servers-enterprise-ar/.
القرار الثالث: أثبت الفائدة في بيئتك
يستشهد README بدراسة أجراها المشروع نفسه (ورقة أولية على arXiv، على 31 مستودعًا) تذكر عشرة أضعاف أقل من التوكنات و2.1 ضعف أقل من استدعاءات الأدوات مقارنة باستكشاف الملفات واحدًا واحدًا. ويذكر أيضًا أزمنة فهرسة على Apple M3 Pro: نواة Linux (28 مليون سطر) في 3 دقائق، وDjango في نحو 6 ثوانٍ. كل هذه الأرقام من المشروع. لم أكرّرها، ولا تقول شيئًا عن مستودعك أو وكيلك.
يقرّ المشروع بذلك في docs/MEASURING_SAVINGS.md. يفصل هذا الدليل بين ثلاثة أسئلة: هل يجيب الوكيل أفضل، وهل الخادم سريع ومستقر، وهل يقلّ استهلاك التوكنات أو الاستدعاءات. استعلام سريع لا يثبت جوابًا صحيحًا، وعدّادات الخادم لا ترى توكنات النموذج. ويطلب الدليل تثبيت التجربة قبل البدء: الـ commit بعينه، ومجموعة الأسئلة، والنطاق المتوقع للأجوبة.
اعتمد هذا المنهج كما هو. اطرح الأسئلة العشرة نفسها على وكيلك مع الخادم وبدونه، وسجّل الدقة وعدد الاستدعاءات والتوكنات. ولمتابعة هذه القياسات عبر الزمن، يشرح https://span.observer/ar/mcp-tool-metrics-ar/ مقاييس أدوات MCP.
مراقبة خادم MCP محلي
يعمل هذا الخادم على جهاز المطوّر لا في الإنتاج، فلا توجد خدمة ويب تُراقَب بالمعنى المعتاد. ومع ذلك تبقى ثلاث نقاط مفيدة. عبر stdio يُحجز الخرج القياسي لـ JSON-RPC الخاص بالبروتوكول، وتذهب رسائل العميل إلى مجرى الأخطاء. وتكتب الخدمة الخلفية أحداثها في ${CBM_CACHE_DIR}/logs/cbm-daemon.log، ويضبط CBM_LOG_LEVEL المستوى (من debug إلى error، أو none). وأخيرًا يفعّل CBM_DIAGNOSTICS لقطة دورية، وتُترك للتشخيص فقط.
إذا كنت تشغّل أسطولًا من الوكلاء، فاربط هذه الاستدعاءات بتتبعاتك: يوضح https://span.observer/ar/monitor-mcp-agents-opentelemetry-ar/ كيفية قياس استدعاءات الأدوات عبر OpenTelemetry. لا يصف README أي تصدير OpenTelemetry لهذا الخادم، فلا تفترض وجوده.
حدود يجب معرفتها
- لم أثبّت البرنامج ولم أجرّبه: كل ما سبق «بحسب README».
- لم أتمكن من إعادة قراءة عدد النجوم ولا حجم الاعتماد الفعلي، لذلك لا أقدّم المشروع كمرجع راسخ.
- CBM Lens تجريبية (0.0.1). ويوضح README أن خادم MCP هو قلب المشروع.
- أرقام التوكنات والأزمنة هي أرقام المشروع، على أحمال خاصة به.
- نتيجة «نظيفة» من
check_index_coverageتعني فقط «لا ثغرات مسجّلة» لا «مكتمل»، بحسب README. - الوضع غير المتزامن يتطلب خادمًا مسنودًا بالخدمة الخلفية؛ ويُرفض أمر CLI منفرد مع
--async.
ممارسات مقترحة
- اقرأ سكربت التثبيت، ثم جرّب أولًا على مستودع لا يحوي أسرارًا.
- أبقِ
auto_indexمعطّلًا إلى أن تحدد المستودعات المعنية. - احتفظ بالـ hooks فقط إذا راجعت ما تضيفه إلى سياق الوكيل.
- قس مع الخادم وبدونه، على أسئلتك وعلى commit ثابت.
- عامل مجلد الفهرس كشيفرة مصدرية: صلاحيات ونسخ احتياطية وحذف عند إغلاق المشروع.
الأسئلة الشائعة
هل يرسل codebase-memory-mcp شيفرتي إلى السحابة؟
بحسب README، يعمل تحليل الشيفرة وتخزين الرسم على جهازك، دون خدمة مستضافة ولا مفتاح API. وقد تنزّل الدردشة المحلية في CBM Lens نموذجًا اختياريًا، ويبقى الاستدلال فيه داخل المتصفح. أما عميل MCP ونموذجه فيريان أجوبة الخادم.
ما الفرق بينه وبين أداة ذاكرة مثل claude-mem؟
تحتفظ أداة الذاكرة بما فعله الوكيل أو تعلّمه. أما هذا الخادم فيصف بنية الشيفرة: الاستدعاءات والاعتماديات والمسارات والبنية التحتية. هما يتكاملان ولا يحل أحدهما محل الآخر.
ما الرخصة وما الإصدار؟
المستودع برخصة MIT. يذكر الملف server.json الإصدار 0.12.1 يوم القراءة، ويُنشر المشروع أيضًا كحزم npm وPyPI بحسب هذا الملف.
الخلاصة
يطرح codebase-memory-mcp سؤالًا وجيهًا: لماذا نعيد قراءة الشيفرة مع كل سؤال ما دامت هناك خريطة محلية؟ قبل اعتماده، راجع المثبّت، واختر إعدادات الفهرسة، ثم قس الفائدة على مستودعاتك أنت. ولمشروع آخر من سجل «Top repos» انظر https://span.observer/ar/opensre-sre-agent-ar/.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. مشروع codebase-memory-mcp مشروع طرف ثالث لا تصدره Dynatrace. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.