MCP Memory Service

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

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

استدعاء هجين بين المتجهات والرمزي — نسبة إيجابيات كاذبة أقل من المخازن القائمة على التضمين فحسب
شبكة معرفية تُبنى تلقائياً تربط الكيانات والقرارات والمشاريع
توحيد في الخلفية: إزالة التكرار والتلخيص والكشف عن الانجراف
REST API جانب MCP — نفس المخزن، عميلان
SQLite أولاً (بدون بنية تحتية)؛ قابل للتوصيل بـ Postgres / pgvector عند التوسع

عرض مباشر

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

mcp-memory-service.replay ▶ جاهز

0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcp-memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcp-memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcp-memory-service",
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-memory-service": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-memory-service"
        ]
      }
    }
  }
}

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

claude mcp add mcp-memory-service -- uvx mcp-memory-service

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

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

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

إبقاء Claude متزامناً عبر مشروع برمجي يمتد لأسابيع

👤 المطورون في مشاريع طويلة الأمد ⏱ ~15 min beginner

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

المتطلبات الأساسية

خدمة الذاكرة تعمل — uvx mcp-memory-service (الافتراضي ~/.mcp-memory.db)

الخطوات

تهيئة السياق الأساسي

Use mcp-memory-service. Store these as project-level memory: 'use bun not npm', 'all DB writes go through src/db/repo.ts', 'no class components in src/ui'.✓ تم النسخ

→ 3 ذاكريات مخزنة بعلامة المشروع
الاستخدام في الجلسة القادمة

Recall any project-level rules before suggesting changes to src/ui/Form.tsx.✓ تم النسخ

→ القواعد ذات الصلة ظاهرة؛ الاقتراح يحترمها
تسجيل القرارات الجديدة

Save: 'switched from React Query to SWR on 2026-04-22 because of Suspense compat'.✓ تم النسخ

→ ذاكرة محفوظة بتاريخ؛ ستظهر المرة القادمة عند الحديث عن الموضوع

النتيجة: Claude يتعامل مع مشروعك كتعامل مستمر لا مئة بداية من الصفر.

المزالق

الذاكرة تنمو بلا حدود؛ الاستدعاء يُعيد أشياء قديمة/غير ذات صلة — شغّل consolidate أسبوعياً؛ ضع علامات للذاكريات حتى تتمكن من تحديد نطاق الاستدعاء للحديث والمشروع الحالي

اجمعها مع: filesystem

منح عامل مساعد شخصي ملفاً دائماً عنك

👤 الأشخاص الذين يبنون عوامل Claude يومية ⏱ ~10 min beginner

متى تستخدمه: يجب أن يعرف عاملك اليومي تفضيلاتك واجتماعاتك المتكررة والأشخاص دون إعادة السؤال.

الخطوات

تهيئة الملف الشخصي

Use mcp-memory-service. Store: my timezone (Asia/Tokyo), my partner's name, my work hours (10–7), recurring 1:1s.✓ تم النسخ

→ ملف شخصي محفوظ بنوع type=profile
الاستدعاء عند الحاجة

Schedule 'lunch w/ Alice' for next Tuesday — pick a time that respects my work hours.✓ تم النسخ

→ الاقتراح يستخدم ساعاتك من الذاكرة؛ لا إعادة سؤال

النتيجة: تعيين سياق أقل تكراراً لكل مهمة.

المزالق

تفاصيل حساسة (طبية، مالية) محفوظة غير مشفرة — استخدم مسار قاعدة بيانات منفصل (FS مشفر أو بناء SQLCipher)؛ أو ببساطة لا تخزن الطبي/المالي في هذه الطبقة

اجمعها مع: google-workspace-mcp

بناء شبكة معرفية بحثية أثناء قراءة الأوراق العلمية

👤 الباحثون والمحللون والقراء المتعمقون ⏱ ~60 min intermediate

متى تستخدمه: تقرأ 30 ورقة وتريد تتبع الكيانات والادعاءات والتناقضات.

الخطوات

الاستيعاب أثناء القراءة

For each paper I link, extract: authors, key claims, methods, datasets — store as linked nodes.✓ تم النسخ

→ عدد العقد ينمو؛ الروابط ظاهرة
إيجاد التناقضات

Across stored papers, find claims that contradict. List with sources.✓ تم النسخ

→ أزواج ادعاءات متعارضة مع مصادر
توليد مراجعة شاملة

Draft a 2-page survey with the dominant claim threads + contradictions noted.✓ تم النسخ

→ مراجعة markdown مع ادعاءات مدعومة بمصادر

النتيجة: تركيب حقيقي، لا مجرد ملاحظات.

المزالق

جودة الاستخراج متفاوتة — بعض الادعاءات ضوضاء — احذف العقد منخفضة الثقة دورياً؛ مهمة التوحيد تساعد لكنها ليست سحراً

اجمعها مع: filesystem

مشاركة سجل قرارات المشروع بين عوامل زملاء الفريق

👤 الفرق الصغيرة التي تستخدم عوامل تطوير بالذكاء الاصطناعي ⏱ ~30 min advanced

متى تستخدمه: ثلاثة أشخاص في الفريق يستخدمون Claude Code؛ لا أحد يعرف القرارات التي اتخذتها عوامل الآخرين.

المتطلبات الأساسية

مثيل مستضاف يمكن الجميع الوصول إليه — شغّل مع --host 0.0.0.0 على صندوق تطوير مشترك؛ أو انشر صورة Docker

الخطوات

توجيه إعدادات الفريق إلى الخدمة المشتركة

Update each teammate's MCP config to use the shared URL with separate auth tokens.✓ تم النسخ

→ كل العوامل تقرأ/تكتب نفس المخزن
الاتفاقية: وسم القرارات

Convention: anything stored as type=decision is team-visible; type=personal is namespaced.✓ تم النسخ

→ العلامات مطبقة؛ الاستدعاء محدد النطاق وفقاً لذلك

النتيجة: ذاكرة على مستوى الفريق دون الحاجة إلى wiki.

المزالق

ملاحظات شخصية تُوسم عن طريق الخطأ كمرئية للفريق — الافتراضي type=personal؛ اجعل type=decision اختياراً صريحاً للملاحظات الجماعية

اجمعها مع: github

التركيبات

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

mcp-memory-service + filesystem

تثبيت الذاكرة في ملفات المستودع — ربط memory_id ↔ مسار الملف

When I edit src/db/repo.ts, recall any decisions referencing it before suggesting changes.✓ تم النسخ

mcp-memory-service + github

تخزين ملخصات مراجعة PR تلقائياً كذاكرة قرارات

After every merged PR, store the design rationale + reviewer concerns as type=decision tagged with the repo.✓ تم النسخ

الأدوات

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

الأداة	المدخلات	متى تستدعيها	التكلفة
store_memory	content, tags?, type?, metadata?	عند أي حقيقة أو قرار يستحق الحفظ	0
recall	query, top_k?, tags?, since?	الخطوة الأولى قبل الإجابة — لا تعيد اختراع السياق	0
graph_neighbors	node_id, depth?	استكشاف الكيانات/القرارات ذات الصلة	0
consolidate	scope?	صيانة أسبوعية؛ دمج التكرارات	رموز LLM للتلخيص
delete_memory	memory_id	الحق في النسيان أو تصحيح بيانات خاطئة	0

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

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

حصة API: لا شيء — كل شيء محلي
الرموز لكل استدعاء: الاستدعاء يعيد 200–2000 رمز حسب top_k
التكلفة المالية: مجاني؛ التوحيد يستخدم نموذج محلي أو BYO LLM
نصيحة: اضبط top_k=5 لمعظم استدعاءات recall؛ دع التوحيد يتولى إزالة التكرار بدلاً من حشو prompts

الأمان

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

الحد الأدنى من الصلاحيات: كتابة filesystem إلى مسار قاعدة البيانات

تخزين بيانات الاعتماد: قاعدة البيانات في ~/.mcp-memory.db؛ شفّر FS أو استخدم بناء SQLCipher للبيانات الحساسة

نقل البيانات الخارجي: لا شيء افتراضياً؛ التوحيد قد يتصل خارجاً إذا ربطته بنموذج لغوي

لا تمنح أبدًا: قاعدة بيانات مقروءة من الجميع على مضيفين مشتركين

المعلومات الشخصية تتدفق عبر الذاكريات — طبّق سياسة الاحتفاظ بالبيانات على مستوى التطبيق

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

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

الاستدعاء لا يُعيد شيئاً

تحقق من فلتر العلامات؛ فهرس التضمينات قد يحتاج إعادة بناء بعد تغييرات المخطط

تحقق: انظر إلى عدد نتائج الأداة والعلامات التي تمررها

أخطاء قفل قاعدة البيانات تحت عوامل متزامنة

انتقل إلى backend Postgres أو فعّل وضع SQLite WAL (الافتراضي في الإصدارات الأخيرة)

تحقق: PRAGMA journal_mode;

التوحيد يعمل إلى ما لا نهاية

حدد النطاق: consolidate(scope='last_week') بدلاً من قاعدة البيانات الكاملة

الذاكريات ممتلئة بمحادثات غير ذات صلة

كن أكثر صرامة عند التخزين — استدع store_memory فقط على الحقائق/القرارات لا المحادثات العادية

تحقق: راجع آخر المخزونات؛ احذف غير المفيد

البدائل