خادم Obsidian MCP

ماذا يفعل خادم “Obsidian” MCP؟

خادم Obsidian MCP هو موصل يمكّن Claude Desktop—أو أي عميل Model Context Protocol (MCP)—من قراءة والبحث في الأدلة التي تحتوي على ملاحظات ماركداون، مثل تلك الموجودة في خزائن Obsidian. يعمل هذا الخادم كجسر بين مساعدات الذكاء الاصطناعي وقواعد المعرفة الشخصية أو الجماعية المخزنة بتنسيق ماركداون، مما يسهل الوصول إلى الملاحظات والبحث فيها واستخدامها ضمن سير عمل التطوير. من خلال التكامل مع مصادر بيانات خارجية مثل Obsidian، يمكّن الخادم أدوات الذكاء الاصطناعي من تنفيذ مهام مثل البحث عن المعلومات أو استرجاع ملاحظات محددة أو تلخيص المحتوى، مما يعزز الإنتاجية وإدارة المعرفة للمطورين والعاملين في المعرفة.

قائمة القوالب

لم يتم ذكر أي قوالب تعليمات برمجية بشكل صريح في الوثائق المتاحة.

قائمة الموارد

لا توجد موارد محددة في الوثائق المقدمة.

قائمة الأدوات

من الوثائق والصور المتاحة، بعد التثبيت، تظهر الأدوات التالية (مع العلم أن الشرح غير موجود في الكود):

• قراءة الملاحظة: تتيح قراءة محتوى ملاحظة محددة في خزينة Obsidian.
• بحث الملاحظات: تتيح البحث عن الملاحظات داخل الخزينة بناءً على كلمات مفتاحية أو استعلامات.

ملاحظة: أسماء الأدوات ووصفها مستنتجة من الوثائق والصور المتاحة؛ التفاصيل الإضافية غير محددة.

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

• إدارة المعرفة الشخصية: البحث والقراءة واسترجاع المعلومات من خزائن Obsidian الشخصية بسلاسة باستخدام Claude Desktop، مما يجعل ملاحظاتك متاحة لنماذج الذكاء الاصطناعي للتلخيص أو الإجابة عن الأسئلة.
• بحث توثيق الفريق: دمج أدلة ماركداون المشتركة كمصادر قابلة للبحث لأعضاء الفريق أو مساعدات الذكاء الاصطناعي، مما يعزز مشاركة المعرفة وتهيئة الأعضاء الجدد.
• مساعدة الذكاء الاصطناعي السياقية: تزويد النماذج الذكية بمعلومات ذات صلة من ملاحظاتك لتحسين دقة وملاءمة الردود المولدة أثناء التطوير أو البحث.
• تلخيص الملاحظات تلقائيًا: استخدم الذكاء الاصطناعي لتلخيص الملاحظات أو المستندات الطويلة داخل خزينة Obsidian الخاصة بك، مما يوفر الوقت على التلخيص اليدوي.

كيفية الإعداد

Windsurf

1. تأكد من تثبيت Node.js وWindsurf.
2. افتح ملف إعدادات Windsurf الخاص بك.
3. أضف التالي إلى قسم mcpServers:

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. احفظ الملف وأعد تشغيل Windsurf.
5. تحقق من أن خادم MCP يعمل ويمكن الوصول إليه.

Claude

1. تأكد من تثبيت Claude Desktop وNode.js.
2. قم بتثبيت Obsidian MCP باستخدام Smithery:

   npx @smithery/cli install mcp-obsidian --client claude
   

3. أعد تشغيل Claude Desktop.
4. تحقق من ظهور أدوات Obsidian MCP في واجهة Claude Desktop.

Cursor

1. تأكد من تثبيت Node.js وCursor.
2. افتح ملف إعدادات Cursor الخاص بك.
3. أضف خادم Obsidian MCP كما يلي:

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. احفظ الملف وأعد تشغيل Cursor.
5. تحقق من وجود خادم Obsidian MCP ضمن قائمة أدوات Cursor.

Cline

1. قم بتثبيت Node.js وCline.
2. حرر ملف إعدادات Cline الخاص بك.
3. أدرج خادم Obsidian MCP:

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. احفظ الإعدادات وأعد تشغيل Cline.
5. تحقق من الإعداد عبر التأكد من ظهور Obsidian MCP في الواجهة.

تأمين مفاتيح API

إذا كان خادم Obsidian MCP أو خزانتك يتطلب المصادقة أو مفاتيح API، استخدم متغيرات البيئة للأمان:

{
  "obsidian": {
    "command": "npx",
    "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"],
    "env": {
      "OBSIDIAN_API_KEY": "${env:OBSIDIAN_API_KEY}"
    },
    "inputs": {
      "vaultPath": "<path-to-your-vault>"
    }
  }
}

كيفية استخدام هذا الخادم MCP داخل التدفقات

استخدام MCP في FlowHunt

لدمج خوادم MCP في سير عمل FlowHunt لديك، ابدأ بإضافة عنصر MCP إلى التدفق الخاص بك وربطه بوكيل الذكاء الاصطناعي لديك:

انقر على عنصر MCP لفتح لوحة الإعدادات. في قسم إعدادات النظام لـ MCP، أدخل تفاصيل خادم MCP الخاص بك باستخدام هذا التنسيق (JSON):

{
  "obsidian": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بعد الإعداد، سيتمكن وكيل الذكاء الاصطناعي من استخدام هذا MCP كأداة مع إمكانية الوصول إلى جميع وظائفه وقدراته. تذكر تغيير “obsidian” إلى اسم خادم MCP الفعلي الخاص بك واستبدال عنوان URL بعنوان خادم MCP الخاص بك.

نظرة عامة

استنادًا إلى ما سبق، فإن خادم Obsidian MCP واضح وسهل الإعداد للبحث والاسترجاع من خزائن Obsidian، ولكنه يفتقر إلى قوالب تعليمات برمجية مفصلة، وتعريفات موارد صريحة، وميزات MCP متقدمة مثل العينات أو الجذور. ومع ذلك، فهو يوفر الأدوات الأساسية لجعل ملاحظات Obsidian متاحة للذكاء الاصطناعي.

تقييم MCP

نظرًا لبساطة ووضوح الغرض وسهولة التثبيت والفائدة المحددة لمستخدمي Obsidian، أقيّم هذا الخادم MCP بـ 6/10. إنه مناسب تمامًا لحالته ولكنه يفتقر إلى ميزات MCP متقدمة وعمق في التوثيق للتوسعية الأوسع.