/ الدليل / الملعب / Memory Bank MCP
← كل الخوادم ↗ GitHub
● مجتمع alioshr 🔑 يتطلب مفتاحك

Memory Bank MCP

بواسطة alioshr · alioshr/memory-bank-mcp

خادم بنك الذاكرة المركزي - احتفظ بملفات ذاكرة Cline/Cursor/Claude في مجلد واحد، مع تحديد نطاقها لكل مشروع، في مأمن من اجتياز المسار.

يقوم Memory-bank-mcp بتحويل نمط Cline Memory Bank إلى خادم MCP مستقل. قم بتوجيهه إلى الدليل الجذر، وسيحصل كل مشروع على مجلد بنك الذاكرة الخاص به والذي يمكن للوكلاء قراءته وكتابته وتحديثه وإدراجه من خلال خمس أدوات بسيطة. تم تصميمه بحيث يشترك العديد من العملاء (Claude Desktop، وCursor، وWindsurf) في نفس الذاكرة الأساسية - ولا تحتاج إلى نسخ منفصلة لكل IDE.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

memory-bank-mcp.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "memory-bank-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "memory-bank-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@allpepper/memory-bank-mcp"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add memory-bank-mcp -- npx -y @allpepper/memory-bank-mcp

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Memory Bank MCP

شارك بنك ذاكرة واحدًا عبر Claude Desktop وCursor وWindsurf

👤 المطورون الذين يتنقلون بين IDEs ويريدون مصدرًا واحدًا للمعرفة بالمشروع ⏱ ~15 min beginner

متى تستخدمه: يمكنك استخدام أكثر من عميل AI والاستمرار في إعادة نسخ نفس الملاحظات حول المشروع.

المتطلبات الأساسية
  • العقدة 18+ — تثبيت nvm 18
  • دليل لعقد بنوك الذاكرة — mkdir -p ~/ai-memory
الخطوات
  1. قم بتعيين MEMORY_BANK_ROOT في تكوين MCP لكل عميل
    قم بتوجيه كل عميل MCP إلى MEMORY_BANK_ROOT=~/ai-memory وقم بتثبيت @allpepper/memory-bank-mcp.✓ تم النسخ
    → تظهر أدوات Memory_bank_* في كل عميل
  2. إنشاء بنك المشروع الأول
    Memory_bank_write project=acme-api file=architecture.md — تلخيص حدود الخدمة لهذا الريبو.✓ تم النسخ
    → يظهر الملف ضمن ~/ai-memory/acme-api/architecture.md
  3. القراءة من عميل مختلف
    في المؤشر: Memory_bank_read project=acme-api file=architecture.md✓ تم النسخ
    → تم إرجاع نفس المحتوى؛ تظهر التعديلات من أي عميل على الفور

النتيجة: مجلد ذاكرة مشترك وقابل للإصدار يستشيره كل IDE تلقائيًا.

المزالق
  • نسيان إعادة تشغيل عميل MCP بعد تغيير MEMORY_BANK_ROOT — إغلاق العميل وإعادة فتحه؛ تتم قراءة env vars فقط عند بدء التشغيل
اجمعها مع: filesystem · github

قم بإعطاء سياق فوري للوكيل الجديد حول مشروع طويل الأمد

👤 تقوم الفرق بتشغيل وكلاء متعددين على نفس قاعدة التعليمات البرمجية ⏱ ~10 min beginner

متى تستخدمه: تحتاج الدردشة الجديدة إلى نفس الخلفية (الاصطلاحات والقرارات السابقة والأخطاء المعروفة) التي تعلمتها الدردشة الأخيرة بالفعل.

المتطلبات الأساسية
  • بنك الذاكرة الموجود لهذا المشروع — قم بملءها أثناء العمل العادي باستخدام Memory_bank_write
الخطوات
  1. قم بإدراج الملفات الموجودة لدى بنك المشروع بالفعل
    اتصل بـ list_project_files للمشروع=acme-api.✓ تم النسخ
    → architecture.md،قرارات.md،open-questions.md، وما إلى ذلك.
  2. تحميل المجموعة الفرعية ذات الصلة
    اقرأ القرارات.md وopen-questions.md قبل بدء المهمة.✓ تم النسخ
    → يشير الوكيل إلى القرارات السابقة بدلاً من إعادة السؤال

النتيجة: تبدأ الجلسات الجديدة دافئة بدلاً من البرودة؛ تتوقف عن دفع ضريبة الإعداد في كل مرة.

المزالق
  • ترك البنك ينمو ليصبح ملفًا واحدًا عملاقًا — مقسمة حسب الاهتمامات - القرارات، والهندسة المعمارية، والأسئلة المفتوحة، ودليل التشغيل - بحيث يقوم الوكيل بتحميل ما يحتاج إليه فقط
اجمعها مع: codebase-memory

قم بإصدار ذاكرة الوكيل الخاصة بك في git مثل أي مستند مشروع آخر

👤 الفرق التي ترغب في بقاء الذاكرة عبر الأجهزة والمساهمين ⏱ ~20 min intermediate

متى تستخدمه: تريد مراجعة ملفات الذاكرة وتعديلها ومشاركتها مع زملائك في الفريق.

المتطلبات الأساسية
  • Git repo لاستضافة البنك — git init داخل MEMORY_BANK_ROOT أو مجلد فرعي للمشروع
الخطوات
  1. جعل الجذر الريبو
    قم بتحويل ~/ai-memory إلى git repo؛ أضف .gitignore لأي شيء حساس.✓ تم النسخ
    → هيكل الريبو git القياسي
  2. اسمح للوكيل بتحديث الذاكرة أثناء الجلسات
    بعد إصلاح الخلل، اتصل بـ Memory_bank_update لتسجيل السبب الجذري في bugs.md.✓ تم النسخ
    → فرق جديد جاهز للالتزام
  3. الالتزام والدفع
    قم بمراجعة فرق الذاكرة والالتزام والدفع.✓ تم النسخ
    → يقوم زملاء الفريق بالسحب ويقوم عملاؤهم بمشاركة السياق على الفور

النتيجة: تصبح ذاكرة الوكيل قطعة أثرية للمشروع من الدرجة الأولى.

المزالق
  • ارتكاب الأسرار التي سجلها الوكيل — قم بإضافة ماسح ضوئي للالتزام المسبق (على سبيل المثال، gitleaks) قبل دفع مستودع الذاكرة
اجمعها مع: github · git

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

memory-bank-mcp + filesystem

يحتفظ بنك الذاكرة بملاحظات الوكيل؛ يقرأ نظام الملفات الكود الذي يشيرون إليه

اقرأ القرارات.md من بنك الذاكرة، ثم افتح الملفات التي تشير إليها في src/.✓ تم النسخ
memory-bank-mcp + github

بعد دمج العلاقات العامة، قم بتسجيل النتيجة في بنك ذاكرة المشروع

قم بتلخيص PR #412 المدمج وتحديث Memory-bank/acme-api/decisions.md.✓ تم النسخ
memory-bank-mcp + codebase-memory

طبقتان متكاملتان من الذاكرة - ذاكرة الرسم البياني للرمز + ملاحظات يمكن للإنسان قراءتها

قم بدمج الرسم البياني لرمز ذاكرة قاعدة التعليمات البرمجية مع السرد في Memory-bank/architecture.md.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
memory_bank_read project: str, file: str اسحب الذاكرة الموجودة قبل التخطيط 0
memory_bank_write project: str, file: str, content: str قم بإنشاء ملف ذاكرة جديد تمامًا 0
memory_bank_update project: str, file: str, content: str تعديل ملف ذاكرة موجود (يفشل في حالة فقدانه) 0
list_projects (none) اكتشف المشاريع التي لديها بالفعل بنوك ذاكرة 0
list_project_files project: str تعرف على ملفات الذاكرة المتوفرة قبل القراءة 0

التكلفة والحدود

تكلفة التشغيل

حصة API
لا توجد واجهة برمجة تطبيقات خارجية
الرموز لكل استدعاء
يعتمد على حجم الملف؛ مذكرة نموذجية 200-2000 الرموز
التكلفة المالية
مجاني - يعمل محليًا
نصيحة
اجعل ملفات الذاكرة قصيرة وموضوعية؛ يؤدي تحميل ملف بحجم 50 كيلو بايت إلى إضاعة السياق في كل مكالمة.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: لا أوراق اعتماد. مسار MEMORY_BANK_ROOT هو التكوين الوحيد.
نقل البيانات الخارجي: لا توجد مكالمات عبر الشبكة — تظل عمليات القراءة والكتابة على نظام الملفات المحلي ضمن MEMORY_BANK_ROOT.

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

خطأ: لم يتم تعيين MEMORY_BANK_ROOT

قم بتعيين env var في تكوين عميل MCP الخاص بك وأعد تشغيل العميل.

تحقق: echo $MEMORY_BANK_ROOT
ENOENT عند قراءة ملف

اتصل بـ list_project_files أولاً — يجب أن يكون اسم الملف موجودًا تمامًا.

تحقق: ls $MEMORY_BANK_ROOT/<project>/
EACCES على الكتابة

تأكد من أن عملية MCP لديها إذن الكتابة على MEMORY_BANK_ROOT.

تحقق: touch $MEMORY_BANK_ROOT/.probe && rm $MEMORY_BANK_ROOT/.probe

البدائل

Memory Bank MCP مقابل البدائل

البديلمتى تستخدمهاالمقايضة
memory (official)تريد رسمًا بيانيًا معرفيًا، وليس ملاحظات قائمة على الملفاتالرسم البياني منظم ولكنه أقل قابلية للتحرير من قبل الإنسان
memory-serviceتريد البحث الدلالي على الذاكرةإعداد أثقل؛ التضمينات المطلوبة
Cline Memory Bank (inline)أنت تستخدم Cline فقط ولا تحتاج إلى مشاركة عبر IDEمقفل على كلاين

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills