/ الدليل / الملعب / MARM-Systems
● مجتمع Lyellr88 ⚡ فوري

MARM-Systems

بواسطة Lyellr88 · Lyellr88/MARM-Systems

ذاكرة مستمرة وقابلة للبحث عبر Claude و Qwen و Gemini وأي عميل MCP — جلسات وأدفتر ملاحظات واستدعاء دلالي في خادم واحد.

MARM-Systems خادم MCP مكتوب بـ Python يوفر لأي عميل ذكاء اصطناعي طبقة ذاكرة مستمرة: جلسات وأدفتر ملاحظات وسجلات سياقية ذات تصنيف تلقائي وبحث متجه دلالي. بروتوكولات STDIO و HTTP و WebSocket. خادم SQLite مع وضع WAL للوصول المتزامن.

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

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

عرض مباشر

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

marm-systems.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "marm-systems": {
      "command": "uvx",
      "args": [
        "MARM-Systems"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "marm-systems": {
      "command": "uvx",
      "args": [
        "MARM-Systems"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "marm-systems": {
      "command": "uvx",
      "args": [
        "MARM-Systems"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "marm-systems",
      "command": "uvx",
      "args": [
        "MARM-Systems"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "marm-systems": {
      "command": {
        "path": "uvx",
        "args": [
          "MARM-Systems"
        ]
      }
    }
  }
}

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

claude mcp add marm-systems -- uvx MARM-Systems

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

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

استخدامات عملية: MARM-Systems

بناء ذاكرة مستمرة عبر الجلسات في مشروع طويل الأمد

👤 أي شخص يعمل على جهد متعدد الأسابيع مع الذكاء الاصطناعي ⏱ ~15 min beginner

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

المتطلبات الأساسية
  • تثبيت MARM-Systems وتشغيله — docker pull lyellr88/marm-mcp-server && docker run -d -p 8001:8001 lyellr88/marm-mcp-server
الخطوات
  1. ابدأ جلسة موسومة بالمشروع
    marm_start مع علامة المشروع 'dataplatform-migration'. سجل أننا نقوم بالترحيل من Redshift إلى Snowflake، الموعد النهائي نهاية Q2.✓ تم النسخ
    → تم بدء الجلسة؛ تم حفظ الإدخال الأولي
  2. أسقط السياق أثناء عملك
    marm_contextual_log: 'قررنا استخدام Fivetran لنسخ CDC، قيّمنا Airbyte لكن التكوين معقد جداً.'✓ تم النسخ
    → تم التصنيف التلقائي والتخزين
  3. في الجلسة التالية، استدعِ
    marm_smart_recall 'ما الذي قررناه بشأن أدوات CDC؟'✓ تم النسخ
    → يظهر القرار السابق ذي الصلة

النتيجة: تبدأ الجلسة N+1 مع جميع سياق الجلسات 1-N قابل للوصول من خلال الاستعلام، بدلاً من إعادة الكتابة.

المزالق
  • تفريغ كل محادثة في الذاكرة يسدّ الاستدعاء — استخدم marm_contextual_log للقرارات والمعالم، وليس كل تبادل
  • البحث المتجه يفوت المصطلحات المتخصصة — ضع علامات على الإدخالات بشكل صريح مع أسماء المشاريع للرجوع إلى الكلمات الرئيسية
اجمعها مع: drift

شارك الذاكرة عبر فريق باستخدام مساعدي ذكاء اصطناعي متعددين

👤 الفرق حيث يستخدم أعضاء مختلفون Claude / Qwen / Gemini ⏱ ~45 min advanced

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

الخطوات
  1. قم بتشغيل MARM كخادم HTTP مشترك
    نشر MARM-Systems على خادم الفريق؛ يشير كل زميل في الفريق عميل MCP الخاص به إلى http://marm.team.internal:8001/mcp.✓ تم النسخ
    → اتصال جميع العملاء
  2. سجل السياق المشترك
    marm_contextual_log: 'دليل النسخ الاحتياطي للقاعدة البيانات موجود في /runbooks/db-backup.md؛ آخر تحديث 2026-04-10.'✓ تم النسخ
    → يمكن للجميع استدعاؤه
  3. استدعِ من أي عميل
    من جلسة Qwen الخاصة بزميل: marm_smart_recall 'كيف أستعيد قاعدة البيانات؟'✓ تم النسخ
    → نفس الإجابة تظهر

النتيجة: ذاكرة مؤسسية مشتركة عبر الذكاء الاصطناعي.

المزالق
  • الذاكرة المشتركة تحتاج إلى OAuth حقيقية — لا تعتمد على بيانات الاعتماد المرمزة في المطور — اربط بـ IdP قبل الاستخدام الإنتاجي
  • تسرب البيانات الحساسة في الاستدعاء المشترك — استخدم علامات المشروع وحدد نطاق الاستعلامات حسب العلامة

استخدم أدفتر الملاحظات كمساحات خدش قابلة للاستعلام من قبل الذكاء الاصطناعي

👤 المتعلمون والباحثون ⏱ ~5 min beginner

متى تستخدمه: تريد منطقة ملاحظات محدودة بموضوع يمكن للذكاء الاصطناعي البحث فيها لاحقاً.

الخطوات
  1. أنشئ دفتر ملاحظات
    marm_notebook_add name='rust-ownership' مع إدخال: 'Move مقابل borrow: move ينقل الملكية، borrow يدعك تلقي نظرة.'✓ تم النسخ
    → تم إنشاء دفتر الملاحظات
  2. أضف أثناء التعلم
    marm_notebook_add 'rust-ownership': 'borrow القابل للتغيير حصري؛ واحد فقط في المرة.'✓ تم النسخ
    → تم إضافة الإدخال
  3. استدعِ لاحقاً
    marm_notebook_show 'rust-ownership'✓ تم النسخ
    → دفتر الملاحظات الكامل

النتيجة: دفتر يوميات تعليمي قابل للاستعلام.

التركيبات

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

marm-systems + drift

drift يتذكر اتفاقيات الكود؛ MARM يتذكر قرارات المشروع

استدعِ اتفاقيات drift وقرارات MARM للمشروع 'dataplatform-migration' ولخص حيث يتفاعلان.✓ تم النسخ
marm-systems + claude-code-organizer

نقل الذكريات قصيرة الأجل من CC إلى MARM للاستدعاء طويل الأجل

أدرج المنظم أكبر 12 ذكرياتي — انقل الخمسة الخاصة بالمشروع إلى دفاتر ملاحظات MARM.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
marm_start project?, tags? في بداية أي جلسة عمل مجاني (محلي)
marm_refresh session_id? إعادة تحميل السياق أثناء الجلسة مجاني
marm_smart_recall query: str, top_k?: int بحث دلالي في الإدخالات السابقة مجاني (التضمينات المحلية)
marm_contextual_log text: str, tags?: str[] الاحتفاظ بقرار/معلم/حقيقة مجاني
marm_log_session session_id مراجعة جلسة سابقة مجاني
marm_notebook_add name: str, entry: str ملاحظات محدودة بموضوع مجاني
marm_notebook_use name: str قم بتثبيت موضوع للجلسة مجاني
marm_notebook_show name: str اقرأ دفتر ملاحظات مجاني
marm_summary scope: session|notebook|tag, id ضغط السجل الطويل مجاني (محلي)
marm_context_bridge from_session, to_session التفكير عبر المشاريع مجاني

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

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

حصة API
لا شيء — محلي فقط
الرموز لكل استدعاء
عادةً ما تتضمن الاستجابات المستدعاة 500-2000 رمز
التكلفة المالية
مجاني، مفتوح المصدر
نصيحة
قم بتدوير أو أرشفة الجلسات القديمة بشكل دوري — SQLite يتعامل مع الحجم لكن جودة الاستدعاء تتدهور مع الضوضاء.

الأمان

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

تخزين بيانات الاعتماد: SQLite محلي؛ للوضع HTTP المشترك استخدم أسرار OAuth المستندة إلى env
نقل البيانات الخارجي: لا شيء افتراضياً (تخزين محلي)؛ إذا قمت بتشغيل مشترك، فقط ضمن شبكتك
لا تمنح أبدًا: تعريض المنفذ 8001 للإنترنت العام بدون طبقة مصادقة

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

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

لا يمكن الاتصال بـ localhost:8001

الحاوية لا تعمل. docker ps للتحقق؛ docker start marm-mcp-server.

تحقق: curl http://localhost:8001/docs
فشل تنزيل نموذج التضمينات

يحمل التشغيل الأول النموذج؛ يحتاج إلى شبكة الإنترنت الخارجة. بعد ذلك، يعمل بدون اتصال.

تحقق: تحقق من سجلات docker لتنزيل HuggingFace
يعود الاستدعاء إلى إدخالات غير ذات صلة

عدد قليل جداً من الإدخالات للتضمينات الجيدة؛ أضف المزيد، أو قم بالتصفية المسبقة حسب العلامة.

تحقق: marm_smart_recall مع تصفية العلامة

البدائل

MARM-Systems مقابل البدائل

البديلمتى تستخدمهاالمقايضة
driftتريد ذاكرة خاصة بالكود (الاتفاقيات والقرارات)التركيز على الكود؛ أقل عمومية
Letta (MemGPT)تريد وكيل ذاكرة بدرجة بحثية، وليس فقط خادمأثقل للتشغيل؛ معمارية آرائية
CC native memoriesClaude Code فقط؛ بدون حاجة عبر العملاءلا بحث دلالي؛ تنتفخ السياق

المزيد

الموارد

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

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

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