/ الدليل / الملعب / mcp-memory-service
← كل الخوادم ↗ GitHub
● مجتمع doobidoo ⚡ فوري

mcp-memory-service

بواسطة doobidoo · doobidoo/mcp-memory-service

ذاكرة دائمة طويلة الأجل للذكاء الاصطناعي مع البحث الدلالي والعلامات واسترجاع بسرعة 5ms ومزامنة سحابية — SQLite محلي وCloudflare للأجهزة المتعددة.

doobidoo/mcp-memory-service هو MCP بـ Python يخزن الذكريات الدلالية للوكلاء. محرك SQLite-vec الافتراضي سريع (5ms)، ومحرك Cloudflare يزامن عبر الأجهزة، وضع مختلط يكتب محليًا أولاً ثم ينسخ بشكل غير متزامن. يتضمن REST API ولوحة تحكم ويب وOAuth 2.0 للوصول البعيد.

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

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

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

عرض مباشر

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

memory-service.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "memory-service",
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "memory-service": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-memory-service"
        ]
      }
    }
  }
}

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

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

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

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

استخدامات عملية: mcp-memory-service

كيفية إعطاء Claude ذاكرة مستقرة لتفضيلاتك وسياقك

👤 مستخدمو الطاقة اليوميون الذين تعبوا من إعادة شرح أنفسهم ⏱ ~10 min beginner

متى تستخدمه: عندما تبدأ كل محادثة جديدة من الصفر وتريد الاستمرارية.

المتطلبات الأساسية
  • تثبيت uvx — brew install uv
الخطوات
  1. بذر التفضيلات
    memory_store: 'أعمل على مشاريع iOS + Swift. أفضل MVVM مع @Observable. دائماً علّق باللغة الإنجليزية.' مع العلامات [preference, coding].✓ تم النسخ
    → تأكيد التخزين
  2. في جلسة مستقبلية، استرجع
    memory_search: 'تفضيلات أسلوب البرمجة الخاص بي'.✓ تم النسخ
    → إرجاع التفضيلات، يطبقها الوكيل
  3. تنظيف التضاؤل
    أريني الذكريات الأقدم من 90 يوماً بدون نقرات حديثة — عرّض الحذف.✓ تم النسخ
    → قائمة قديمة للمراجعة

النتيجة: يتصرف Claude كما لو أنه يتذكرك.

المزالق
  • تخزين معلومات شخصية حساسة تصبح قابلة للاسترجاع للأبد — لا تفعل — تعامل مع الذاكرة كدفتر عام. استخدم العلامات للفصل.

كيفية مشاركة مجموعة ذاكرة عبر فريق عبر محرك Cloudflare

👤 الفرق التي تشغل سير عمل الذكاء الاصطناعي المشترك ⏱ ~30 min advanced

متى تستخدمه: عندما تريد أن تتذكر كل محادثة مهندس نفس قرارات العمارة.

المتطلبات الأساسية
  • حساب Cloudflare مع Workers KV أو D1 — cloudflare.com، تثبيت كما هو محدد في وثائق محرك Cloudflare
الخطوات
  1. تبديل المحرك
    Configure MCP_MEMORY_BACKEND=cloudflare مع بيانات اعتماد CF في env.✓ تم النسخ
    → نقاط نهاية الذاكرة تشير إلى CF
  2. بذر الذاكرة المشتركة بين الفريق
    memory_store: 'المصادقة الخاصة بنا توجد في services/auth. دائماً دوّر مفاتيح JWT عبر هدف Make rotate-keys.' مع العلامة 'team-arch'.✓ تم النسخ
    → تم التخزين
  3. تحقق من جهاز ثانٍ
    memory_search 'خدمة المصادقة' — يجب أن تُرجع نفس الإدخال.✓ تم النسخ
    → نتيجة عبر الأجهزة

النتيجة: ذاكرة مؤسسية مشتركة تبقى بعد دوران الفريق.

المزالق
  • تسرب البيانات الحساسة في الذاكرة المشتركة عبر الفرق — قم بتشغيل محركات منفصلة لكل فريق؛ لا تخزن الأسرار

كيفية حصد التعلم تلقائياً في نهاية جلسة البرمجة

👤 مطورو العمل بمفردهم الذين يستخدمون الوكلاء بكثافة ⏱ ~5 min beginner

متى تستخدمه: في نهاية محادثة البرمجة الزوجية، قبل الإغلاق.

الخطوات
  1. شغّل الحاصدة
    memory_harvest على هذه المحادثة — استخرج الحقائق الدائمة (أنماط مفاتيح API، قرارات المشروع، المشاكل المعروفة). تجاهل الثرثرة.✓ تم النسخ
    → قائمة منظمة من الذكريات المرشحة
  2. وافق + احفظ
    احفظ العناصر 1، 3، 5 كذكريات مع العلامة 'project-x'. احذف الباقي.✓ تم النسخ
    → عدد محفوظ

النتيجة: التقاط منخفض الاحتكاك لما تعلمته، بلا أكثر.

التركيبات

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

memory-service + contextplus

استخدم Context+ لحالة الريبو الحية، memory-service للحقائق الدائمة عبر الجلسات

احفظ قرار العمارة هذا في memory-service وربطه بالملفات ذات الصلة عبر رسم بياني ذاكرة Context+.✓ تم النسخ
memory-service + github

بعد كل PR مدمجة، احصد التعلم في الذاكرة

ملخص آخر 10 PRs مدمجة في org/repo، استخرج الأخطاء المتكررة، وخزنها كذكريات مع العلامة 'code-review-lessons'.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
memory_store content: str, tags?: str[] احفظ حقيقة دائمة 1 embedding
memory_search query: str, tags?: str[], limit?: int استرجع الذكريات ذات الصلة 1 vector search (local)
memory_harvest transcript: str حصد نهاية الجلسة 1 LLM call
memory_store_session session_id, messages أدخل كل محادثة N embeddings

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

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

حصة API
SQLite-vec: محلي غير محدود. ChromaDB: محلي. Cloudflare: الطبقة المجانية Workers/KV/D1 سخية.
الرموز لكل استدعاء
Store: ~100 رموز للمحتوى. Search: ~50 رموز لكل نتيجة.
التكلفة المالية
مجاني (مفتوح المصدر). محرك Cloudflare: الطبقة المجانية عادة كافية.
نصيحة
ابدأ بـ SQLite-vec. التبديل إلى مختلط فقط عندما تحتاج إلى مزامنة متعددة الأجهزة.

الأمان

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

الحد الأدنى من الصلاحيات: نظام الملفات المحلي لوضع SQLite رمز Cloudflare API لوضع CF
تخزين بيانات الاعتماد: بيانات اعتماد CF عبر متغيرات البيئة
نقل البيانات الخارجي: محلي (SQLite) أو حساب Cloudflare الخاص بك (CF)
لا تمنح أبدًا: لا تدع المطالبات غير الموثوقة تستدعي memory_store — هجمات التسميم

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

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

ModuleNotFoundError: sqlite_vec

pip/uv تثبيت مع إضافة sqlite-vec: uvx 'mcp-memory-service[sqlite]'

تحقق: python -c 'import sqlite_vec'
Cloudflare backend 403

الرمز ينقصه أذونات Workers/KV. أنشئ رمز CF API جديد بالنطاقات المحددة.

Memories returned aren't relevant

أعد التضمين مع نموذج أفضل — الافتراضي هو MiniLM المحلي؛ قم بالترقية إلى nomic-embed عبر متغير البيئة.

memory_harvest outputs duplicates

فعّل إعداد dedup؛ ستتخطى الحاصدة العناصر ذات التشابه الكوسيني > 0.95 مع الموجودة.

البدائل

mcp-memory-service مقابل البدائل

البديلمتى تستخدمهاالمقايضة
mem0عندما تريد ذاكرة مستضافة SaaSمدفوعة بعد الطبقة المجانية؛ مقيدة بالمورد
contextplus memory graphعندما تريد ذاكرة مدمجة بإحكام مع فهم الكودمحدودة لريبو، وليست للاستخدام العام

المزيد

الموارد

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

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

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