Claude Historian MCP — حالات الاستخدام, التثبيت & عرض مباشر

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

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

أداتان: البحث (11 نطاقًا) والفحص (ملخص الجلسة)
يقرأ من ~/.claude/conversations/ - لا توجد خدمة خارجية
TF-IDF + مطابقة غامضة مع اكتشاف نمط سير العمل
مسح المشروع الموازي؛ لا يوجد فهرس مستمر للمحافظة عليه
معرفات الجلسة ذات البادئة القصيرة مدعومة

عرض مباشر

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

claude-historian-mcp.replay ▶ جاهز

0/0

التثبيت

اختر العميل

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

{
  "mcpServers": {
    "claude-historian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  }
}

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

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

{
  "mcpServers": {
    "claude-historian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-historian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-historian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-historian-mcp",
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-historian-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "claude-historian-mcp"
        ]
      }
    }
  }
}

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

claude mcp add claude-historian-mcp -- npx -y claude-historian-mcp

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

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

استخدامات عملية: Claude Historian

اكتشف كيف قمت بإصلاح خطأ مماثل من قبل

👤 المطورون الذين يستخدمون Claude Code عبر العديد من الجلسات ⏱ ~5 min beginner

متى تستخدمه: أنت ترتكب خطأً يبدو مألوفًا؛ تريد أن ترى ما نجح في المرة الأخيرة.

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

كلود كود مع سجل المحادثات الموجود — الافتراضي — التاريخ موجود في ~/.claude/conversations/

الخطوات

أخطاء البحث

ابحث في سجلي عن "ECONNREFUSED redis" - النطاق: الأخطاء.✓ تم النسخ

→ قائمة مرتبة بالجلسات السابقة التي ظهر فيها هذا الخطأ
فحص أفضل ضرب

فحص الجلسة abc12345 - ما هو الحل؟✓ تم النسخ

→ ملخص يسمي السبب الجذري والإصلاح المطبق

النتيجة: سابقة ملموسة في ثوان، وليس إعادة التصحيح من الصفر.

المزالق

الوثوق بالملخص دون قراءة الجلسة — استخدم الفحص للملخص، ثم افتح ملف الجلسة للاختلافات الفعلية

اجمعها مع: filesystem

سحب خطة التنفيذ السابقة لإعادة استخدامها

👤 أي شخص يخطط بشكل متكرر للمهام مع كلود ⏱ ~10 min beginner

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

الخطوات

خطط البحث

نطاق البحث: الخطط، لـ "إعادة محاولة مهمة الخلفية مع التراجع الأسي".✓ تم النسخ

→ تتضمن الزيارات عناوين الخطة ومعرف الجلسة
فحص والتكيف

فحص الضربة العليا. تلخيص الخطة والتكيف مع قوائم الانتظار المدعومة من Postgres.✓ تم النسخ

→ خطة معدلة في نفس الهيكل الأصلي

النتيجة: إعادة استخدام التفكير دون إعادة إنشاء السقالة.

اجمعها مع: codebase-memory

ابدأ جلسة جديدة بسياق سابق

👤 مستخدمي كود كلود الثقيلة ⏱ ~10 min intermediate

متى تستخدمه: لقد بدأت محادثة جديدة حول مشروع قديم ولا تريد إعادة شرح السياق.

الخطوات

البحث عن إشارات المشروع

نطاق البحث: جلسات "acme-api billing"، مجموعة حسب المشروع.✓ تم النسخ

→ الجلسات 3-5 الأكثر صلة بهذا المشروع
فحص لترطيب

فحص الجلسة 7f3e2a10. تلخيص القرارات المعمارية والأخطاء المعروفة.✓ تم النسخ

→ ملخص نظيف يؤسس للجلسة الجديدة

النتيجة: تبدأ الجلسة الجديدة من حيث توقفت آخر جلسة مفيدة.

المزالق

تحميل عدد كبير جدًا من الجلسات في وقت واحد والغرق في السياق — الوصول إلى أعلى 5 نقاط؛ استخدم الفحص على الأفضل فقط

اجمعها مع: memory-bank-mcp

التركيبات

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

claude-historian-mcp + filesystem

بعد الفحص، افتح الملفات المشار إليها لمعرفة الاختلافات الفعلية

افحص الجلسة X. ثم افتح الملفات المذكورة وأظهر الأجزاء ذات الصلة.✓ تم النسخ

claude-historian-mcp + memory-bank-mcp

تعزيز الإصلاح لمرة واحدة في الذاكرة الدائمة

يبدو الإصلاح من الجلسة X محملاً؛ أضفه إلى بنك الذاكرة/<project>/bugs.md.✓ تم النسخ

claude-historian-mcp + codebase-memory

قم بتأسيس نتائج نص المؤرخ في الرسم البياني للرمز

تلمس الجلسة X fn retryBilling - أرني المتصلين الحاليين عبر ذاكرة قاعدة التعليمات البرمجية.✓ تم النسخ

الأدوات

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

الأداة	المدخلات	متى تستدعيها	التكلفة
search	query: str, scope: one-of (conversations\|errors\|plans\|config\|tasks\|sessions\|tools\|similar\|memories\|…), limit?: int	ابحث عن المحادثات السابقة المتعلقة بمهمتك الحالية	0
inspect	session_id: str (full UUID or short prefix)	احصل على ملخص يمكن قراءته بواسطة الإنسان لجلسة واحدة	0

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

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

حصة API: لا شيء - فحص الملفات المحلية
الرموز لكل استدعاء: يعتمد على حجم النتيجة؛ سقف مع الحد
التكلفة المالية: حر
نصيحة: استخدم نطاقات ضيقة (الأخطاء والخطط) بدلاً من "المحادثات" لإبقاء الردود صغيرة.

الأمان

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

تخزين بيانات الاعتماد: لا أوراق اعتماد. يعمل على الملفات المحلية فقط.

نقل البيانات الخارجي: لا شيء يترك جهازك. خادم MCP يقرأ فقط ~/.claude/conversations/.

يمكن أن يحتوي سجل محادثاتك على أسرار قمت بلصقها مسبقًا. التنقيح هو مسؤوليتك قبل مشاركة نتائج البحث.
الأجهزة المشتركة: يمكن للمستأجر الذي يتمتع بإمكانية الوصول إلى دليل منزلك قراءة جميع الجلسات السابقة. قم بحماية ~/.claude كما تحمي ~/.ssh.

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

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

لا توجد نتائج على الرغم من أنك تعلم بوجود المحادثة

جرب النطاق = 'المحادثات' وقم بإرخاء الاستعلام؛ تحقق من أن ~/.claude/conversations/ ليس فارغًا.

تحقق: ls ~/.claude/conversations/ | head

يقول الفحص أنه لم يتم العثور على الجلسة لبادئة قصيرة

تبدأ جلسة أخرى بنفس البادئة. استخدام المزيد من الشخصيات.

تحقق: Grep session IDs: grep -r -l '<prefix>' ~/.claude/conversations/

بطيء في التواريخ الكبيرة جدًا

تمرير نطاق أضيق والحد؛ تقوم الأداة بالمسح عند الطلب، لذا فإن التواريخ الضخمة تكلف أكثر لكل استعلام.

تحقق: du -sh ~/.claude/conversations/

البدائل

Claude Historian مقابل البدائل

البديل	متى تستخدمها	المقايضة
memory-bank-mcp	أنت تريد ذاكرة منسقة على مستوى المشروع بدلاً من البحث في السجل الأولي	يجب أن تكون مأهولة بالسكان. ليس استرجاعًا حرًا
codebase-memory	تريد رسمًا بيانيًا رمزيًا للتعليمات البرمجية، وليس البحث عن المحادثة	طبقة مختلفة
filesystem	تفضل إجراء المحادثات بنفسك	تفقد التسجيل والمطابقة الغامضة وملخصات الجلسة

Claude Historian

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

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

عرض مباشر

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

التثبيت

اختر العميل

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

استخدامات عملية: Claude Historian

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

الخطوات

المزالق

الخطوات

الخطوات

المزالق

التركيبات

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

الأدوات

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

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

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

الأمان

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

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

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

البدائل

Claude Historian مقابل البدائل

المزيد

الموارد