موجز: يقوم codebase-memory-mcp بفهرسة المستودع الخاص بك في رسم بياني معرفي دائم، بحيث يجيب وكيل البرمجة الخاص بك على الأسئلة الهيكلية من الرسم البياني بدلاً من البحث والقراءة للوصول إلى المعلومات. يقيس المشروع خمس استعلامات هيكلية بحوالي 3,400 رمز مميز عبر الرسم البياني مقابل حوالي 412,000 رمز مميز من خلال الاستكشاف ملفًا بملف، وهو تخفيض بنسبة 99.2%. مكتوب بلغة C، ويأتي كتطبيق ثنائي أصلي واحد بدون وقت تشغيل ولا مفتاح API، ويغطي أكثر من 160 لغة، ويعمل بالكامل على جهازك. 41,536 نجمة اعتبارًا من 1 سبتمبر 2026، مرخص بترخيص MIT. إذا قمت بتثبيت شيء واحد من موجة أدوات الوكلاء لعام 2026، فليكن هذا.
هذا استعراض متعمق لأداة واحدة من قائمتنا التي تضم خمس أدوات وكلاء ذكاء اصطناعي مفتوحة المصدر تستحق التثبيت في عام 2026.
اسأل وكيلك عن مكان استدعاء دالة وشاهد ما يحدث. يبحث. يقرأ ثلاثة ملفات. يبحث مرة أخرى بنمط مختلف. يقرأ أربعة ملفات أخرى. في النهاية يجيب، بشكل صحيح، بعد أن استهلك عشرات الآلاف من الرموز المميزة لملء سياقه بكود المصدر الذي سينساه في اللحظة التي تنتهي فيها الجلسة.
ثم تسأل سؤال متابعة ويكرر العملية بأكملها مرة أخرى.
هذه الحلقة هي حيث يذهب معظم حد استخدامك في جلسة طويلة، وهي أيضًا السبب في تدهور جودة الإجابات على مدار فترة الظهيرة: نافذة سياق مليئة بمحتويات الملفات تترك مساحة أقل للاستنتاج. يهاجم codebase-memory-mcp كلتا المشكلتين بنفس الخطوة.
ماذا يفعل
يقوم بتحليل المستودع الخاص بك إلى رسم بياني معرفي دائم للدوال والفئات وسلاسل الاستدعاء ومسارات HTTP والروابط عبر الخدمات، ثم يجيب على الأسئلة الهيكلية من هذا الرسم البياني.
يتم التحليل عبر تحليل AST بواسطة tree-sitter لأكثر من 160 لغة، مع طبقة LSP هجينة تضيف تحليل النوع الدلالي لمجموعة أساسية يعدها شعار README عشرة: بايثون، وعائلة تايب سكريبت وجافا سكريبت بما في ذلك JSX وTSX، وPHP، وC#، وGo، وC، وC++، وجافا، وكوتلين، وRust، وPerl. التمييز مهم. يخبرك تحليل AST بأن هناك دالة تسمى save؛ بينما يخبرك تحليل النوع إلى أي فئة تنتمي.
تُعرض النتيجة في شكل 15 أداة MCP تغطي البحث، وتتبع سلسلة الاستدعاءات، ونظرة عامة على البنية، وتحليل التأثير، وفحوصات تغطية الفهرس، واستعلامات Cypher ضد الرسم البياني، واكتشاف الكود الميت، والربط عبر خدمات HTTP، وإدارة سجل قرارات التصميم (ADR). يمكن لأي عميل يتحدث بروتوكول سياق النموذج (Model Context Protocol) استخدامه، ويسرد المشروع 45 سطح وكيل مدعومًا بما في ذلك Claude Code، وCodex، وCursor، وWindsurf، وOpenCode، وGemini CLI، وAider، وKilocode.
الأرقام
مجموعتان مستقلتان، وكلتاهما تستحق القراءة بعناية.
قياس المشروع الخاص: استهلكت خمس استعلامات هيكلية حوالي 3,400 رمز مميز عبر الرسم البياني مقابل حوالي 412,000 رمز مميز عبر استكشاف ملفًا بملف باستخدام grep. هذا يمثل تخفيضًا بنسبة 99.2%، أو حوالي 120 ضعفًا أقل من الرموز المميزة لنفس الإجابات.
النسخة الأكاديمية موجودة في مسودة بحثية، Codebase-Memory: رسوم بيانية معرفية قائمة على Tree-Sitter لاستكشاف كود LLM عبر MCP، تم تقييمها عبر 31 مستودعًا واقعيًا. تُفيد بـ 83% جودة إجابة، و10 أضعاف رموز أقل، و2.1 ضعفًا أقل من استدعاءات الأدوات مقارنة بالاستكشاف ملفًا بملف.
الفجوة بين 120 ضعفًا و10 أضعاف هي الجزء الصادق. الرقم 120 ضعفًا يمثل خمس استعلامات هيكلية، وهي أفضل حالة للرسم البياني، لأن الأسئلة الهيكلية هي بالضبط ما صمم الرسم البياني لأجله. الرقم 10 أضعاف هو مزيج أوسع عبر 31 مستودعًا، وهو أقرب إلى ما ستراه في الاستخدام اليومي. كلاهما كبير. خذ رقم 10 أضعاف كرقم تخطيطي لك واعتبر أي شيء أفضل كفائدة إضافية.
السرعة هي النصف الآخر. يستغرق فهرسة نواة Linux، 28 مليون سطر عبر 75,000 ملف، ثلاث دقائق. يتم فهرسة المستودعات المتوسطة في أجزاء من الثانية. تعود الاستعلامات الهيكلية في أقل من جزء من الثانية. خط الأنابيب يعتمد على ذاكرة الوصول العشوائي (RAM-first) مع ضغط LZ4، وSQLite في الذاكرة، ومطابقة الأنماط Aho-Corasick المدمجة، ويتم تحرير الذاكرة بعد الفهرسة.
كتابته بلغة C بدلاً من TypeScript أو Python هو السبب في وجود هذه الأرقام، وهو أيضًا السبب في عدم وجود وقت تشغيل للتثبيت.
تثبيته
لنظامي macOS وLinux:
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
لنظام Windows، بالخطوات التي يوصي بها المشروع بدلاً من أمر واحد مباشر:
Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1
notepad install.ps1 # read it first
Unblock-File .\install.ps1
.\install.ps1
تشمل الخيارات --skip-config للثنائي فقط بدون إعداد وكيل، و--dir=<path> لموقع مخصص. يقوم المثبت بالكشف التلقائي عن وكلاء البرمجة المثبتين ويكتب إدخالات MCP الموثقة الخاصة بهم، بالإضافة إلى التعليمات والمهارات وخطافات دورة الحياة حيث يدعمها العميل. على نظام macOS، يقوم بتجريد سمات الحجر الصحي والتوقيع على الثنائي بشكل مؤقت، لذا لا يلزم عمل يدوي باستخدام xattr أو codesign.
ثم أعد تشغيل وكيلك وأخبره بفهرسة المشروع.
علامتا تهيئة تستحقان الضبط في اليوم الأول:
# index new projects automatically on first connection
codebase-memory-mcp config set auto_index true
codebase-memory-mcp config set auto_index_limit 50000
# graph visualization, built into the binary
codebase-memory-mcp --ui=true --port=9749
تعرض واجهة المستخدم على localhost:9749 الرسم البياني المعرفي ثلاثي الأبعاد. إنها مفيدة حقًا لاكتشاف الهياكل التي لم تكن تعلم بوجودها، وهي بمثابة فحص جيد للتأكد من أن الفهرس غطى ما توقعته.
إذا كنت تعمل عبر العديد من المستودعات، فإن auto_watch false يمنع الجلسة من تسجيل مشروعها مع المراقبة الخلفية، وwatcher_enabled false يوقف خيط الاستطلاع بالكامل. تتم قراءة الخيار الثاني مرة واحدة عند بدء تشغيل الخلفية، لذا أوقف تشغيل الخلفية بعد تغييره.
شيئان يجب التحقق منهما قبل تشغيله
كلاهما موثق من قبل المشروع، وهي علامة جيدة، وكلاهما يستحق ثلاثين ثانية من اهتمامك.
قد يضع Microsoft Defender علامة على ملف ثنائي للإصدار على أنه Trojan:Script/Wacatac.B!ml. يوثق المشروع هذا كإيجابي كاذب معروف، ويلاحظ أن 61 من أصل حوالي 62 محركًا عادة ما تعطي نتائج نظيفة، ويشير إلى أن نفس عائلة الكشف تصيب واجهة سطر الأوامر الخاصة بـ GitHub، وllama.cpp، وGodot، وسلسلة أدوات Go الخاصة بـ Microsoft. يتم فحص كل إصدار على VirusTotal قبل النشر وتربط ملاحظات الإصدار بالنتائج. هذا موقف أكثر شفافية مما تتخذه معظم المشاريع، والمشكلة الأساسية هي مشكلة إرشادية معروفة مع الثنائيات الأصلية الصغيرة غير الموقعة.
يقرأ كودك ويكتب في ملفات تهيئة وكيلك. هذا هو العمل، ويقول المشروع ذلك بوضوح بدلاً من إخفائه. التخفيفات حقيقية: الكود المصدري الكامل متاح تحت ترخيص MIT، وتحمل الإصدارات بطاقة أداء OpenSSF ومستوى SLSA 3 من المصدر، والمعالجة محلية بالكامل. ويصرح المشروع أيضًا بأنه لا يقوم بأي طلب شبكة من تلقاء نفسه، ولا يتحقق من التحديثات في الخلفية، ولا يتصل بالخادم الأم. تتم التحديثات من خلال نص التثبيت الموضوع بجانب الملف الثنائي بدلاً من داخل العملية قيد التشغيل، وهو خيار تصميم مدروس تم شرحه بالتفصيل في ملف README.
الاستجابة الصحيحة لكلا الأمرين هي نفسها: اقرأ نص التثبيت قبل تمريره إلى bash، وتحقق بنفسك من ادعاء العمل المحلي فقط إذا كان ذلك يهمك. عدد النجوم الكبير هو شهرة، وليس تدقيقًا.
لماذا هذا هو ما يجب تثبيته أولاً
كل أداة أخرى في موجة الوكلاء الحالية تغير سير عملك. الشخصيات تغير طريقة توجيه الأوامر. أشجار العمل المتوازية تغير طريقة تنظيم العمل. الوصول إلى الويب يغير ما تطلبه.
هذا لا يغير شيئًا في طريقة عملك ويجعل كل جلسة أرخص وأفضل. لا توجد عادة جديدة لتعلمها. تقوم بتثبيته، وفهرسة المشروع، ويتوقف وكيلك عن استنزاف السياق في حلقات grep. في عملية إعادة هيكلة طويلة، فإن الفرق بين الوصول إلى حدك في الساعة 2 ظهرًا وإنهاء اليوم ليس خفيًا.
تأثير الجودة هو النصف الذي لا يُقدر حق قدره. الوكيل الذي ينفق 400,000 رمز مميز في قراءة الملفات يمتلك مساحة أقل بكثير للتفكير الفعلي في مشكلتك، وتتدهور قدرته على استدعاء ما قرأه في بداية الجلسة. الإجابة من رسم بياني تبقي السياق حرًا. ينطبق نفس الديناميكية على ما تعيده أدواتك إلى هذا السياق، وهو موضوع نوافذ سياق استجابة أداة الوكيل، وهو نفس الفشل الذي يجعل استجابات API المنتفخة باهظة الثمن في سير عمل الوكلاء.
الأدوات التي ستستخدمها بالفعل
خمسة عشر أداة MCP تبدو وكأنها الكثير لتعلمه. في الممارسة العملية لن تتعلم أيًا منها، لأن الوكيل يختار. ما يستحق المعرفة هو الأسئلة التي أصبح لها الآن إجابة رخيصة، لذا تبدأ في طرحها.
تحليل التأثير هو الأعلى قيمة والأقل استخدامًا. قبل تغيير توقيع دالة، اسأل ما الذي سيتعطل. يتتبع الرسم البياني كل مستدعٍ عبر المستودع في أقل من جزء من الثانية، حيث يفوت إصدار grep الإرسال الديناميكي ويتخلى عن أي شيء غير مباشر. هذا يحول "أعتقد أن هذا آمن" إلى قائمة.
تتبع سلسلة الاستدعاءات يجيب على كيفية وصول التنفيذ فعليًا إلى جزء من الكود. مفيد في المستودعات غير المألوفة وأفضل بكثير من القراءة صعودًا عبر خمسة ملفات على أمل العثور على نقطة الدخول.
نظرة عامة على البنية توفر خريطة هيكلية بدون أن يقرأ الوكيل الشجرة بأكملها. هذا هو ما يجعل الانضمام إلى قاعدة بيانات غير معروفة يبدو مختلفًا، ويتناسب جيدًا مع شخصية استكشافية للقراءة فقط.
اكتشاف الكود الميت يجد ما لا يستدعيه أحد. قم بتشغيله قبل عملية تنظيف سريعة بدلاً من الجدال حوله.
الربط عبر خدمات HTTP يتتبع استدعاءً في خدمة واحدة إلى المعالج في خدمة أخرى. في قاعدة بيانات الخدمات المصغرة، هذا هو الفرق بين وكيل يفهم مستودعًا واحدًا ووكيل يفهم النظام بأكمله. وهو أيضًا المكان الذي تظهر فيه فجوة العقد أدناه بالضبط.
استعلامات Cypher هي مخرج الطوارئ. عندما تريد شيئًا محددًا لا تغطيه الأدوات الأخرى، يمكنك استعلام الرسم البياني مباشرة.
التحول العملي يكمن في كيفية توجيهك للأسئلة. الأسئلة التي كنت تتجنبها سابقًا لأنها تكلف 50,000 رمز مميز ودقيقتين أصبحت الآن شبه مجانية، لذا اسألها. "ما الذي يستدعي هذا؟" قبل كل إعادة هيكلة. "كيف يبدو مسار الطلب لنقطة النهاية هذه؟" قبل التصحيح. الأداة تغير اقتصاديات الفضول، وهذا أهم من أي ميزة فردية.
ما يعرفه الرسم البياني وما لا يعرفه
هنا الحد الفاصل، وهو حد حاد يستحق الفهم قبل أن تفرط في الثقة بالأداة.
الرسم البياني مبني من كودك. إنه يعرف ما هو كودك . من بين الأدوات الخمسة عشر، يوجد ربط HTTP عبر الخدمات، والذي يتتبع استدعاءً في خدمة واحدة إلى المعالج في خدمة أخرى، وهذا أمر مفيد حقًا لوكيل أن يعرفه.
ما لا يمكن أن يخبرك به هو ما يقوله العقد . إنه يعرف أن المسار /v1/invoices/{id} موجود وأي دالة تخدمه. لا يعرف أن نقطة النهاية تُرجع 409 مع غلاف خطأ مختلف عندما يتم إعادة استخدام مفتاح عدم التكرار، أو أن حقل status يحتوي على خمس قيم صالحة بالضبط، أو أن المؤشر معتم بدلاً من كونه إزاحة، أو أن حقلاً ما أصبح مهملًا وسيختفي في الربع التالي. لا شيء من ذلك يمكن اشتقاقه من مصدر المعالج، لأن معظمه هو اتفاق وليس تطبيقًا.
لذلك، الوكيل، وهو الآن مزود باستدعاء هيكلي مثالي، لا يزال يخمن العقد. يكتب عميلاً بناءً على شكل مستنتج ويختبره مقابل نموذج افتراضي اخترعه، وكل شيء يكون أخضر حتى مرحلة النشر.
هذا هو السبب في أن Apidog وأداة كهذه تتناسبان معًا بدلاً من التداخل:
- يجيب الرسم البياني على "أين". أي معالج، أي سلسلة استدعاءات، وماذا يتعطل إذا تغير هذا التوقيع.
- يجيب المواصفات على "ماذا". مخططات حقيقية، رموز حالة حقيقية، أغلفة أخطاء حقيقية، يقرأها الوكيل بدلاً من إعادة بنائها. المنطق موجود في استخدام مواصفات OpenAPI كأدوات للوكيل.
- يتم إنشاء النماذج الافتراضية من المواصفات، بما في ذلك فروع الأخطاء التي لن يفكر الوكيل أبدًا في تزويرها.
- تفشل اختبارات العقد في التكامل المستمر (CI) عندما تختلف التطبيق والاتفاق، وهو نمط الفشل الموضح في ماذا يحدث عندما تتسبب تغييرات API في تعطيل وكلاء الذكاء الاصطناعي.
هناك تناسق جميل في الأمر. يوجد codebase-memory-mcp لأن قراءة المصدر للإجابة على الأسئلة الهيكلية مكلفة وغير موثوقة. وينطبق الشيء نفسه على قراءة المصدر لاستنتاج عقد، والإجابة هي نفسها: قم بفهرسة الشيء مرة واحدة، في شكل مصمم للسؤال. قم بتنزيل Apidog إذا كانت وكلاءك يكتبون عملاء API مقابل أشكال لم يدونها أحد. ذات صلة: تصميم مخططات أدوات API للوكلاء وهل ما زلت بحاجة إلى أداة API في عصر وكلاء الذكاء الاصطناعي.
ذاكرة الكود ليست ذاكرة العمل
الحد الثاني هو تنظيمي.
يعيش الفهرس في دليل ذاكرة التخزين المؤقت على جهاز واحد، تحت حساب واحد. يتم مشاركته عبر جلسات Claude Code وCodex وOpenCode المحلية من خلال برنامج خفي للتنسيق، وهو جزء جيد من الهندسة، ويتوقف عند حدود ذلك الجهاز.
والأهم من ذلك، أن الرسم البياني هو ذاكرة قاعدة الكود، وليس ذاكرة العمل. يمكنه إخبارك أن مساعد إعادة المحاولة يستدعي عميل المدفوعات. لا يمكنه إخبارك لماذا تغير التراجع في يوليو، من اتخذ هذا القرار، ما هو البديل، أو ما إذا كان أي شخص قد راجعه. هذا التاريخ كان موجودًا في جلسة طرفية اختفت.
يشعر الفرق بهذه الفجوة الغريبة: الوكيل لديه قدرة استدعاء أفضل للكود من أي إنسان في الفريق، ولا يتذكر على الإطلاق القرارات التي أنتجته.
تغطي Sharkly النصف الآخر بجعل المهمة السجل الدائم بدلاً من المطالبة:
- يعيش العمل كمهام، ويهبط إخراج الوكيل كتعليقات ترد عليها. يتدفق التقدم واستدعاءات الأدوات إلى المهمة. يبقى الاستنتاج بعد انتهاء الجلسة.
- الوكيل هو تهيئة محفوظة. التعليمات، وقت التشغيل، المهارات، المستودعات، البيئة. يتم إعادة استخدام الإعداد حيث يمتلك وكيلك الفهرس والمواصفات والأذونات الصحيحة بدلاً من إعادة بنائه لكل جهاز.
- التنفيذ خاص بك. تقوم بتوصيل جهاز كمبيوتر، يمكن أن يكون جهاز الكمبيوتر المحمول الخاص بك، خادمًا، أو حاوية، وتستخدم Sharkly وقت التشغيل المثبت بالفعل عليه. هذا ذو صلة مباشرة هنا، لأن الفهرس يكون لكل جهاز: معرفة أي جهاز كمبيوتر يحمل المستودع المفهرس هو الفرق بين الرسم البياني الساخن وبداية باردة تستغرق ثلاث دقائق.
- يتم تشغيل عمل المستودع في شجرة عمل منفصلة لكل مهمة، بحيث لا تتصادم المهام المتوازية ضد نفس المستودع.
- المهمة في قائمة الأعمال المتراكمة (Backlog) لا تبدأ التشغيل، لذا يتم إعداد العمل قبل تنفيذ أي شيء.
- هيكل يفهمه الفريق بالفعل: مساحات، مشاريع، سباقات، مهام، مع مزامنة Jira.
ذاكرة الكود بالإضافة إلى ذاكرة العمل هي المزيج. تمنح إحدى الأدوات وكيلك القدرة على استدعاء المستودع. والأخرى تمنح فريقك القدرة على استدعاء ما فعله الوكلاء فيه.
الأسئلة الشائعة
هل يعمل مع Cursor وCodex وOpenCode، أم مع Claude Code فقط؟ إنه خادم MCP، لذا فإن أي عميل MCP يعمل. يسرد المشروع 45 سطح وكيل مدعومًا ويكتشف المثبت تلقائيًا ما لديك. إذا كنت تقارن عملاء الوكلاء لعمل API، فراجع نظرتنا إلى عملاء API في Cursor وCopilot.
هل يغادر كودك جهازك؟ لا. تتم المعالجة محليًا بالكامل، ويصرح المشروع بأنه لا يقوم بأي طلب شبكة من تلقاء نفسه ولا يتحقق من التحديثات في الخلفية. المصدر مرخص بـ MIT إذا أردت التحقق من ذلك بدلاً من الأخذ به على محمل الثقة.
هل تخفيض الرموز بنسبة 99% واقعي لمستودعي؟ الرقم 99.2% يخص خمس استعلامات هيكلية، وهي أقوى حالة للرسم البياني. الرقم الذي تمت مراجعته من قبل الزملاء عبر 31 مستودعًا هو 10 أضعاف رموز أقل و2.1 ضعفًا أقل من استدعاءات الأدوات. خطط على أساس 10x. الأعمال التي تتطلب أسئلة هيكلية مكثفة ستتجاوز هذا.
ما هو حجم المستودع الذي يمكنه التعامل معه؟ الحالة القصوى المعلنة هي نواة Linux بحجم 28 مليون سطر و75,000 ملف في ثلاث دقائق. الحد الافتراضي للفهرسة التلقائية قابل للتكوين عند 50,000 ملف. يتم فهرسة مستودعات التطبيقات العادية في أجزاء من الثانية.
لماذا يضع Defender علامة عليه؟ إيجابي كاذب معروف للتعلم الآلي على الثنائيات الأصلية الصغيرة غير الموقعة. يوثق المشروع ذلك، ويلاحظ أن 61 من أصل حوالي 62 محركًا تعطي نتائج نظيفة، ويربط بنتائج VirusTotal لكل إصدار. نفس عائلة الكشف تصيب واجهة سطر الأوامر الخاصة بـ GitHub وسلسلة أدوات Go الخاصة بـ Microsoft.
هل هذا يحل محل قراءة الكود؟ بالنسبة للأسئلة الهيكلية، نعم، وهذا هو معظم ما يسأله الوكلاء. أما بالنسبة للسلوك، والحالات القصوى، والقصد، فلا. وبالنسبة لما ترجعه واجهة برمجة التطبيقات (API)، تحتاج إلى مواصفات بدلاً من أي منهما، وهذا هو الجدل في هل ما زلت بحاجة إلى أداة API في عصر وكلاء الذكاء الاصطناعي.
خاتمة
هذه هي الأداة الأقل بريقًا في موجة وكلاء 2026 والأكثر عائدًا. لا تغيير في سير العمل، لا عادة جديدة، تطبيق ثنائي أصلي واحد، وتخفيض مقاس بمقدار الرتبة في الرموز التي ينفقها وكيلك للإجابة على أسئلة لا ينبغي له البحث عنها. كما أنها تحقق أقصى فائدة عندما يعمل عدة وكلاء في وقت واحد، وهو ما ينطبق على Orca. قم بتثبيتها، وفهرسة مشروعك، وضبط auto_index، وافتح عارض الرسم البياني مرة واحدة لترى ما بناه.
ثم كن واضحًا بشأن الحدود. يعرف الرسم البياني مكان كودك، وليس ما تعد به واجهة برمجة التطبيقات (API) الخاصة بك، وهذه الفجوة هي ما يسده Apidog بمواصفات، ونموذج وهمي، ومجموعة اختبار. ويتذكر المستودع، وليس العمل، وهو ما تسده Sharkly بجعل المهمة هي السجل بدلاً من المطالبة.
الاستدعاء المثالي للكود هو أساس قوي. إنه ليس نفس معرفة ما هو صحيح أو ما تم اتخاذه من قرارات.