Obsidian MCP Tools

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

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

إضافة Obsidian محلية + جسر MCP
بحث دلالي عبر تكامل Smart Connections
تنفيذ prompts Templater من Claude
CRUD كامل للملفات: قراءة وكتابة وإلحاق وربط وfrontmatter
مدرك للملاحظات اليومية والمجلة
بيانات vault لا تغادر جهازك

عرض مباشر

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

obsidian-mcp-tools.replay ▶ جاهز

0/0

التثبيت

اختر العميل

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

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

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

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

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "obsidian-mcp-tools",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "obsidian-mcp-tools": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "obsidian-mcp-tools"
        ]
      }
    }
  }
}

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

claude mcp add obsidian-mcp-tools -- npx -y obsidian-mcp-tools

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

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

استخدامات عملية: Obsidian MCP Tools

كيفية الاستعلام الفعلي من دماغك الثاني بدلاً من grep

👤 مستخدمو Obsidian لإدارة المعرفة الشخصية مع 1000+ ملاحظة ⏱ ~20 min intermediate

متى تستخدمه: تعرف أنك كتبت عن شيء قبل أشهر لكن البحث بالكلمات المفتاحية يفوّته باستمرار.

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

Obsidian + هذه الإضافة + إضافة Smart Connections — ثبّت كليهما من Community Plugins؛ Smart Connections ستُفهرس في أول تشغيل

الخطوات

التحقق من الفهرس

Verify Smart Connections has finished embedding my vault. Report total notes indexed.✓ تم النسخ

→ عدد الملاحظات المُفهرسة؛ نموذج embedding المستخدم
الاسترجاع الدلالي

Find notes related to 'why I left my last job' even if those exact words aren't in any note.✓ تم النسخ

→ 5 ملاحظات مرتبة حسب التطابق الدلالي مع مقتطفات
التأليف

Synthesize those into a short reflection note. Save under /Reflections/ with a wikilink to each source.✓ تم النسخ

→ ملاحظة جديدة منشأة؛ الروابط الخلفية تعمل

النتيجة: دماغ ثانٍ يُجيب بالمفاهيم لا بالكلمات المفتاحية.

المزالق

الاسترجاع الدلالي يُظهر ملاحظات شخصية حساسة — استخدم إعداد excludedFolders في Smart Connections لتجاوز المجلدات الخاصة

اجمعها مع: humanizer-skill

تشغيل قالب Templater من Claude مع ملء prompts تلقائياً

👤 مستخدمو Obsidian المتقدمون الذين لديهم قوالب ⏱ ~10 min intermediate

متى تستخدمه: لديك قالب Templater لـ 'انطلاق مشروع' يسأل 5 أسئلة؛ تفضّل أن يُنظّمها Claude.

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

Templater مثبّت مع قوالب مُعدّة — إضافة مجتمعية قياسية

الخطوات

سرد القوالب

What Templater templates are available?✓ تم النسخ

→ قائمة القوالب مع أوصاف prompts
التشغيل مع الملء التلقائي

Run 'project_kickoff' for a project called 'Q3 onboarding overhaul'. Auto-answer the prompts based on context.✓ تم النسخ

→ ملاحظة جديدة منشأة باستخدام القالب؛ prompts مملوءة

النتيجة: القوالب تعمل من محادثة بدلاً من نافذة حوار.

المزالق

بعض أوامر Templater غير متزامنة وتحتاج وقتاً — أداة MCP تنتظر الاكتمال — لكن لا تُسلسل الكثير في استدعاء واحد

بناء ملاحظة يومية تلقائياً من تقويم الأمس والمهام

👤 مستخدمو Obsidian المهتمون بالإنتاجية ⏱ ~15 min intermediate

متى تستخدمه: تبدأ كل يوم بتعديل نفس قالب 'اليومي' — أتمته.

الخطوات

سحب بيانات اليوم

Read yesterday's daily note. Carry forward incomplete tasks. Pull today's calendar via google-calendar MCP.✓ تم النسخ

→ المهام المُرحَّلة + أحداث اليوم محدّدة
كتابة الملاحظة اليومية

Create today's daily note in /Daily/$(date +%F).md with the standard sections.✓ تم النسخ

→ ملاحظة منشأة ومفتوحة

النتيجة: ملاحظة يومية جاهزة في 5 ثوانٍ.

المزالق

الترحيل يُضاعف المهام إن كانت نفس المهمة في يومين — أزل التكرار حسب نص السطر قبل الكتابة

اجمعها مع: google-calendar

التركيبات

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

obsidian-mcp-tools + google-calendar

بناء ملاحظات يومية تتضمن أحداث اليوم

Make today's daily note. Include calendar events under '## Today'.✓ تم النسخ

obsidian-mcp-tools + github

مطابقة لوحة مشروع في ملاحظة vault

Sync GitHub project XYZ tasks to /Projects/XYZ.md as a checklist.✓ تم النسخ

الأدوات

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

الأداة	المدخلات	متى تستدعيها	التكلفة
search_semantic	query, k?	الاسترجاع على مستوى المفهوم	1 Smart Connections query
read_note	path	سحب ملاحظة واحدة	free
write_note	path, content, mode: 'create'\|'append'\|'overwrite'	إنشاء أو تحديث ملاحظة	free
list_templates	(none)	اكتشاف ما يمكن تنفيذه	free
run_templater	template_name, prompt_answers: {}	تنفيذ سير عمل من قالب	free

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

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

حصة API: محلي — مرتبط بخدمة embedding في Smart Connections إن كانت سحابية
الرموز لكل استدعاء: 100–1500 لكل ملاحظة
التكلفة المالية: مجاني (الإضافة)؛ Smart Connections لديها خيار محلي مجاني + سحابي مدفوع
نصيحة: استخدم خيار embedding المحلي في Smart Connections لتجنب تكلفة الاستعلام

الأمان

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

تخزين بيانات الاعتماد: إضافة محلية فقط؛ لا تخزين عن بُعد

نقل البيانات الخارجي: محلي — إلا إن إعداد Smart Connections لاستخدام embeddings سحابية

لا تمنح Claude صلاحية كتابة للـ vault إلا إن كنت تثق بـ prompt الخاص بك؛ استخدم مجلدات الاستثناء للمناطق الحساسة

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

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

أدوات MCP لا تظهر

تأكد أن إضافة Obsidian مُفعَّلة وعملية جسر MCP تعمل

تحقق: تحقق من شريط حالة الإضافة؛ أعِد تشغيل Obsidian

search_semantic لا يُرجع شيئاً

قد تكون مهمة embedding في Smart Connections لم تنتهِ بعد — تحقق من تقدمها

تحقق: افتح شريط جانب Smart Connections

write_note يفشل بـ 'path outside vault'

المسارات نسبية لجذر vault؛ لا تستخدم مسارات مطلقة

البدائل