/ الدليل / الملعب / Obsidian MCP Server
← كل الخوادم ↗ GitHub
● مجتمع cyanheads 🔑 يتطلب مفتاحك

Obsidian MCP Server

بواسطة cyanheads · cyanheads/obsidian-mcp-server

اجعل خزنة Obsidian الخاصة بك مورد MCP من الدرجة الأولى - ثماني أدوات للملاحظات والعلامات والموضوع الأمامي والبحث العام عبر البرنامج الإضافي Local REST API.

يقوم cyanheads/obsidian-mcp-server بتوصيل أي عميل MCP (Claude Desktop، Cursor، Cline، Windsurf) إلى قبو Obsidian من خلال البرنامج الإضافي لمجتمع Obsidian Local REST API. يحصل الوكلاء على قراءة/كتابة الملاحظات، وأوضاع الإلحاق/الإلحاق/الكتابة الفوقية، وتعديلات المادة الأمامية الذرية، وإدارة العلامات، والبحث في المخزن الكامل - كل ذلك بدون فتح Obsidian. يقوم بتخزين البيانات الوصفية التي تم تحليلها للاستعلامات المتكررة السريعة.

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

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

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

عرض مباشر

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

obsidian-mcp-server.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "obsidian-mcp-server",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "obsidian-mcp-server": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "obsidian-mcp-server"
        ]
      }
    }
  }
}

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

claude mcp add obsidian-mcp-server -- npx -y obsidian-mcp-server

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

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

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

قم بتدوين الأفكار في مذكرة اليوم اليومية من أي عميل MCP

👤 مستخدمو Obsidian الذين يعيشون في الدردشة ⏱ ~5 min beginner

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

المتطلبات الأساسية
  • سبج مع تمكين البرنامج المساعد Local REST API — المكونات الإضافية للمجتمع ← تثبيت "Local REST API" ← انسخ مفتاح API
  • تم تكوين عميل MCP باستخدام OBSIDIAN_API_KEY + OBSIDIAN_BASE_URL — انظر كتلة التكوين؛ عنوان URL الأساسي عادةً ما يكون http://127.0.0.1:27123
الخطوات
  1. التحقق من وجود المذكرة اليومية
    قائمة الملاحظات ضمن Daily/2026-04-17.md.✓ تم النسخ
    → تم تأكيد مسار الملف أو "لم يتم العثور عليه"
  2. إلحاق الالتقاط
    قم بإلحاق "- الفكرة: جرب X بحثًا عن خطأ التخزين المؤقت" إلى Daily/2026-04-17.md.✓ تم النسخ
    → تم تأكيد الإلحاق دون الكتابة فوق الإدخالات السابقة

النتيجة: مجلة جارية يمكن للوكلاء الإضافة إليها، دون التلاعب بها أبدًا.

المزالق
  • استخدام وضع الكتابة الفوقية عندما تقصد الإلحاق — قم دائمًا بإلحاق الملاحظات اليومية أو إضافتها مسبقًا؛ حفظ الكتابة فوق المسودات الجديدة
اجمعها مع: filesystem

تحويل أسبوع من الملاحظات إلى وثيقة مراجعة

👤 يقوم عمال المعرفة بإجراء مراجعات أسبوعية ⏱ ~20 min intermediate

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

المتطلبات الأساسية
  • الملاحظات الموسومة أو المؤرخة — استخدم #أسبوعيًا أو يوميًا/ مجلدًا
الخطوات
  1. ابحث في ملاحظات الأسبوع
    البحث الشامل: تم تعديل الملاحظات هذا الأسبوع ضمن Daily/.✓ تم النسخ
    → قائمة من 5 إلى 7 مسارات للملفات
  2. قراءة كل منهما
    اقرأ كل ملاحظة يومية وقم بتلخيصها حسب الموضوع.✓ تم النسخ
    → الرصاصات تحت عنوان، وليس تسلسل الخام
  3. اكتب المراجعة
    اكتب الملخص إلى Reviews/2026-W16.md؛ إضافة حالة المادة الأمامية: مراجعة، العلامات: [أسبوعيًا].✓ تم النسخ
    → ملف جديد مع الواجهة المناسبة

النتيجة: مذكرة مراجعة أسبوعية مبنية على المواد الخام بدون نسخ ولصق يدوي.

اجمعها مع: github

توحيد العلامات الفوضوية عبر القبو

👤 الخزائن التي نمت بشكل عضوي ولديها الآن متغيرات #Work / #work / #WORK ⏱ ~30 min intermediate

متى تستخدمه: قائمة العلامات طويلة جدًا بسبب التكرارات وشبه التكرارات.

الخطوات
  1. قائمة العلامات الحالية
    استخدم obsidian_manage_tags لسرد جميع العلامات المصنفة حسب الاستخدام.✓ تم النسخ
    → تظهر أعداد العلامات التكرارات
  2. اقتراح رسم الخرائط
    اقترح مجموعة أساسية ورسم خرائط من القديم → الجديد.✓ تم النسخ
    → طاولة صغيرة قابلة للمراجعة
  3. تطبق دفعة واحدة
    بعد التأكيد، أعد تسمية العلامات عبر المخزن باستخدام التعيين.✓ تم النسخ
    → تلخيص عمليات العلامة لكل ملاحظة

النتيجة: تصنيف العلامات النظيفة الذي يمكنك التنقل فيه بالفعل.

المزالق
  • إعادة كتابة مئات الملاحظات دفعة واحدة دون الحاجة إلى نسخة احتياطية — قم بإلزام القبو بالبوابة أولاً؛ مراجعة الفرق
اجمعها مع: git

قم بإسقاط قصاصات الويب في صندوق بريد البحث ووضع علامة عليها تلقائيًا

👤 الباحثون والمحللون وأي شخص لديه عادة قص الشعر ⏱ ~15 min beginner

متى تستخدمه: يتراكم البريد الوارد/المجلد بشكل أسرع مما يمكنك معالجته.

المتطلبات الأساسية
  • صندوق الوارد / المجلد المخصص — قم بإنشائه في القبو
الخطوات
  1. قائمة البريد الوارد
    قم بإدراج الملاحظات غير المميزة ضمن علبة الوارد/.✓ تم النسخ
    → مسارات العناصر المعلقة
  2. التصنيف والعلامة
    لكل منها، اقترح 1-3 علامات بناءً على المحتوى، ثم قم بتطبيقها باستخدام obsidian_manage_tags.✓ تم النسخ
    → تمت إضافة العلامات ذريًا عبر المادة الأمامية

النتيجة: يظل البريد الوارد صغيرًا؛ يتم تنظيم المقاطع الجديدة تلقائيًا.

اجمعها مع: fetch

التركيبات

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

obsidian-mcp-server + fetch

قم بقص عنوان URL باستخدام أداة الجلب، ثم اكتبه في البريد الوارد/

قم بإحضار https://... واحفظ الملخص المنظف في Inbox/YYYY-MM-DD-title.md مع المادة الأمامية المناسبة.✓ تم النسخ
obsidian-mcp-server + github

انسخ ملخصات العلاقات العامة المدمجة في Projects/<repo>.md

ابحث عن العلاقات العامة المدمجة هذا الأسبوع وألحق ملخصًا ضمن ## الأسبوع 16 في Projects/acme-api.md.✓ تم النسخ
obsidian-mcp-server + git

قم بإصدار قبو الخاص بك والتزم بتغييرات الدفعة

بعد تنظيف العلامة، قم بتشغيل git diff على المخزن وقم بتلخيصه قبل الالتزام.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
obsidian_read_note path: str اقرأ ملاحظة محددة قبل تحريرها أو تلخيصها 0
obsidian_update_note path: str, content: str, mode: 'append'|'prepend'|'overwrite' إضافة أو استبدال محتوى الملاحظة - الإلحاق الافتراضي ما لم تتم إعادة الكتابة 0
obsidian_search_replace path: str, find: str, replace: str عمليات التحرير المستهدفة في الملاحظة دون إعادة إنشاء الملف بأكمله 0
obsidian_global_search query: str, filters? ابحث عن الملاحظات عبر القبو بأكمله 0
obsidian_list_notes folder?: str قم بتعداد الملاحظات في مجلد قبل العمليات المجمعة 0
obsidian_manage_frontmatter path: str, op: 'get'|'set'|'delete', key?: str, value?: any تغيرات ذرية في المادة الأمامية على المستوى الرئيسي 0
obsidian_manage_tags path?: str, op: 'list'|'add'|'remove' عمليات النظافة والتصنيف 0
obsidian_delete_note path: str إزالة ملاحظة - بشكل دائم، لا يمكن التراجع 0

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

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

حصة API
لا توجد واجهة برمجة تطبيقات خارجية — تعمل واجهة برمجة تطبيقات REST المحلية على جهاز Mac/PC الخاص بك
الرموز لكل استدعاء
بحجم الملاحظة؛ نموذجي 200-3000
التكلفة المالية
حر
نصيحة
تفضل global_search + القراءة عند الطلب بدلاً من إدراج المجلدات بأكملها في السياق بشكل مجمّع.

الأمان

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

تخزين بيانات الاعتماد: OBSIDIAN_API_KEY في env var فقط - لم يتم الالتزام به مطلقًا. تعامل معه كرمز إداري محلي لخزنتك.
نقل البيانات الخارجي: كل حركة المرور هي مضيف محلي → Obsidian Local REST API. لا توجد مكالمات سحابية من هذا الخادم.

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

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

تم رفضه 127.0.0.1:27123

Obsidian لا يعمل أو تم تعطيل المكون الإضافي Local REST API. افتح Obsidian وقم بتمكين البرنامج المساعد.

تحقق: curl -H 'Authorization: Bearer $OBSIDIAN_API_KEY' http://127.0.0.1:27123/vault/
401 غير مصرح به

لا يتطابق OBSIDIAN_API_KEY مع المفتاح الحالي للمكون الإضافي. انسخ القيمة من إعدادات البرنامج المساعد مرة أخرى.

تحقق: Plugin Settings → Local REST API → copy the API key
404 في ملف معروف

المسار نسبي للمخزن وحساس لحالة الأحرف - قم بالتأكيد باستخدام obsidian_list_notes.

تحقق: obsidian_list_notes folder='Daily'

البدائل

Obsidian MCP Server مقابل البدائل

البديلمتى تستخدمهاالمقايضة
obsidian-plugin-skillتريد من Claude أن يساعد في تأليف مكونات Obsidian الإضافية، وليس تحرير محتوى المخزننطاق مختلف
filesystem MCPأنت جيد في التعامل مع عمليات الملفات الأولية ولا تحتاج إلى واجهات برمجة تطبيقات الواجهة الأمامية/العلامات المدركة لـ Obsidianستفقد عمليات العلامة الذرية/المادة الأمامية

المزيد

الموارد

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

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

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