عن المشروع

Zikra هو خادم ذاكرة دائم ومتوافق مع MCP، ومُحسَّن للاستخدام مع Claude Code والوكلاء الذكاء الاصطناعي الآخرين. يصفه README كطبقة ذاكرة مشتركة ومُحكَّمة للفرق التي تُشغّل عدة وكلاء وأشخاص ومشاريع. يمكن تشغيل الخادم محليًا، ويرتبط افتراضيًا بـ localhost:8000، ويستخدم مصادقة رمز Bearer. يمكن إضافته إلى Claude Code كخادم MCP عبر عنوان URL ورأس Authorization، ويوفّر المشروع مثبتًا تفاعليًا بالإضافة إلى نص تحديث. تشمل القدرات الأساسية دعم الوكلاء المتعددين (Claude Code، Gemini CLI، Codex، أو أي وكيل يمكنه POST)، والوصول القائم على الأدوار مع أدوار المالك، المشرف، المطور، والمشاهد، ومساحات أسماء معزولة للمشاريع بحيث يمكن لفريق واحد الاحتفاظ بمجموعات ذاكرة منفصلة لكل مشروع. الذاكرة منظمة وليست نصًا عاديًا: تغطي مجموعة الأوامر حفظ الذكريات والمطالبات، تسجيل التشغيل والأخطاء، حفظ وسرد المتطلبات، ترقية أنواع المتطلبات، واسترجاع العناصر حسب العنوان أو المعرف. يُوصف البحث بأنه هجين بين المعنى والكلمات الأساسية عندما تكون التضمينات مفعلة؛ بدون OPENAI_API_KEY، يقول README إنه يعود إلى البحث بالكلمات الأساسية فقط. يأخذ الترتيب في الاعتبار العمر، وتواتر الوصول، ودرجة الثقة. يمكن للتخزين استخدام SQLite للإعدادات المحلية أو الفردية، أو PostgreSQL للنشر الجماعي. يتم ضبط خلفية PostgreSQL عبر DB_BACKEND ومتغيرات DB_* البيئية، مع وجود خيار تثبيت إضافي لـ postgres. يذكر وصف المستودع أيضًا pgvector وn8n كجزء من الحزمة، ونقطة نهاية أمر webhook الموثقة هي /webhook/zikra. يمكن للتضمينات استخدام OpenAI أو نقطة نهاية متوافقة عبر OPENAI_API_BASE. تشمل خيارات التكوين الرمز، إعدادات قاعدة البيانات، عنوان الارتباط، المنفذ، المشروع الافتراضي، نموذج التضمين، أيام الاضمحلال، ووزن التواتر. بالنسبة إلى Claude Code، تُحفّز المطالبات الإعدادية تثبيت خطافات Stop وPreCompact بالإضافة إلى شريط حالة، مما يتيح تسجيل الجلسة التلقائي. يُوصف مطياف صحة مدمج لاضمحلال الثقة، واكتشاف اليتيم، وتنظيف القديم.