/ الدليل / الملعب / mcp-logseq
● مجتمع ergut ⚡ فوري

mcp-logseq

بواسطة ergut · ergut/mcp-logseq

اجعل رسم بياني Logseq قابلاً للاستعلام بالذكاء الاصطناعي — اقرأ الصفحات وأنشئ كتل وابحث حسب الخاصية وقم بتشغيل استعلامات DSL — عبر HTTP API المحلي الخاص بـ Logseq.

يربط mcp-logseq من قبل ergut عميل MCP بـ HTTP API المحلي الخاص بـ Logseq. تغطي 16 أداة أساسية الصفحات والكتل وأسماء النطاقات والروابط الخلفية واستعلامات DSL. يضيف البحث المتجهي الاختياري الاستدعاء الدلالي في جميع أنحاء الرسم البياني.

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

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

عرض مباشر

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

logseq.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "logseq",
      "command": "uvx",
      "args": [
        "mcp-logseq"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "logseq": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-logseq"
        ]
      }
    }
  }
}

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

claude mcp add logseq -- uvx mcp-logseq

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

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

استخدامات عملية: mcp-logseq

قم بصياغة دفتر اليوميات اليومي لهذا اليوم من أسبوعك

👤 مستخدمو Logseq المتقدمون ⏱ ~10 min beginner

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

المتطلبات الأساسية
  • Logseq مع تفعيل HTTP API — الإعدادات > الميزات > تفعيل HTTP APIs؛ إنشاء رمز API
  • متغيرات البيئة LOGSEQ_API_TOKEN + LOGSEQ_API_URL — اضبط في إعدادات عميل MCP الخاص بك
الخطوات
  1. اسحب صفحات دفتر اليوميات من الأسبوع الماضي
    احصل على محتوى صفحات دفتر اليوميات اليومية لهذا الأسبوع (من يوم الاثنين إلى اليوم).✓ تم النسخ
    → محتويات الصفحة في اليوم
  2. تلخيص والصياغة
    لخص المواضيع وقم بصياغة دفتر اليوميات لهذا اليوم مع قسم مراجعة الأسبوع.✓ تم النسخ
    → الصياغة جاهزة للصق
  3. الكتابة مرة أخرى
    تحديث صفحة دفتر اليوميات لهذا اليوم وإلحاق قسم مراجعة الأسبوع.✓ تم النسخ
    → تم تحديث الصفحة

النتيجة: انعكاس أسبوعي شامل مع حد أدنى من الكتابة.

المزالق
  • update_page في وضع الإضافة يكرر المحتوى عند إعادة المحاولة — استخدم وضع الاستبدال للعمليات الخاملة، أو تحقق من المحتوى الموجود أولاً
  • تسرب الوسوم الحساسة إلى الملخصات — اضبط LOGSEQ_EXCLUDE_TAGS=private,#secret لإخفاء تلك الوسوم

ابحث عن الصفحات حسب الخاصية لتنظيف المهام

👤 مستخدمو Logseq الذين لديهم صفحات على طراز المهام ⏱ ~15 min beginner

متى تستخدمه: تقوم بوسم صفحات المشروع بـ status:: active وتريد قائمة.

الخطوات
  1. البحث حسب الخاصية
    find_pages_by_property: status=active. أرجع الأسماء والتحديث في.✓ تم النسخ
    → قائمة الصفحات
  2. الفرز
    بالنسبة لكل واحد، احصل على الصفحة وأخبرني آخر 3 كتل — هل هناك إجراء تالي واضح؟✓ تم النسخ
    → حالة كل صفحة

النتيجة: مراجعة المشاريع النشطة مع إجراءات تالية واضحة.

الاستدعاء الدلالي عبر الرسم البياني بالكامل

👤 الباحثون الذين لديهم رسم بياني Logseq ضخم ⏱ ~10 min intermediate

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

المتطلبات الأساسية
  • قاعدة بيانات المتجهات المتزامنة — قم بتشغيل sync_vector_db مرة واحدة؛ أعد التشغيل بعد الاستيرادات الكبيرة
الخطوات
  1. البحث المتجهي
    vector_search: 'ماذا لاحظت عن test pyramid مقابل honeycomb؟'✓ تم النسخ
    → مطابقات مرتبة
  2. اسحب الصفحة الكاملة
    احصل على محتوى الصفحة في المطابقة الأعلى.✓ تم النسخ
    → المحتوى الكامل

النتيجة: العثور على الملاحظات حسب المعنى وليس الكلمات الدقيقة.

تحويل صفحة الاجتماع إلى عناصر إجراء مرصودة

👤 مديرو المنتجات وقادة الفريق ⏱ ~10 min beginner

متى تستخدمه: تلتقط الاجتماعات في Logseq وتريد فصل الإجراءات.

الخطوات
  1. اقرأ صفحة الاجتماع
    احصل على محتوى الصفحة لـ 'Meeting/2026-04-14/engineering-sync'.✓ تم النسخ
    → الملاحظات
  2. استخراج الإجراءات
    حدد سطور على طراز TODO. لكل واحد، أنشئ كتلة فرعية تحت دفتر اليوميات لهذا اليوم مع المسؤول والموعد النهائي.✓ تم النسخ
    → تم إنشاء الكتل

النتيجة: تم رفع الإجراءات من الملاحظات إلى قائمة قابلة للتتبع.

التركيبات

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

logseq + marm-systems

استدعاء قصير المدى في MARM؛ ملاحظات دائمة في Logseq

انقل هذه السجلات السياقية MARM إلى Logseq كصفحات تحت /Notes/2026-04.✓ تم النسخ
logseq + filesystem

تصدير صفحات Logseq المنسقة إلى ملفات Markdown

صدّر جميع الصفحات المميزة بـ #public إلى ./exports/public-notes/ كملفات .md منفصلة.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_pages (لا يوجد) نظرة عامة على الرسم البياني مجاني (API محلي)
get_page_content name: str اقرأ صفحة مجاني
create_page name, content, properties? صفحة جديدة مجاني (كتابة)
update_page name, content, mode: append|replace تعديل صفحة موجودة مجاني (كتابة)
delete_page name: str مدمر — تأكيد مجاني
search query: str الب��ث في النص الكامل مجاني
query dsl: str استعلام Logseq DSL مجاني
find_pages_by_property key: str, value?: str تصفية حسب الخصائص مجاني
get_page_backlinks name: str من يرتبط بهذه الملاحظة مجاني
insert_nested_block parent_uuid, content, position: child|sibling أضف محتوى منظم مجاني (كتابة)
vector_search query: str الاستدعاء الدلالي مجاني (تضمينات محلية)

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

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

حصة API
بلا حد — HTTP API المحلي الخاص بـ Logseq غير محدود
الرموز لكل استدعاء
صغير للقائمة/البحث؛ يمكن أن تكون الصفحات طويلة
التكلفة المالية
مجاني
نصيحة
للرسوم البيانية بـ 10000+ صفحة، احتفظ بقاعدة بيانات المتجهات متزامنة كل ليلة بدلاً من كل استعلام.

الأمان

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

تخزين بيانات الاعتماد: LOGSEQ_API_TOKEN في متغير البيئة
نقل البيانات الخارجي: الكل محلي إلى Logseq؛ تبقى تضمينات المتجهات على جهازك
لا تمنح أبدًا: كشف HTTP API الخاص بـ Logseq على شبكتك المحلية بدون جدار حماية

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

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

تم رفض الاتصال على localhost:12315

ابدأ HTTP API عبر أيقونة المقبس في Logseq. إنها معطلة افتراضياً.

تحقق: curl http://localhost:12315
401 على استدعاءات API

الرمز مفقود أو غير متطابق. أعد الإنشاء في رموز التفويض الخاصة بـ Logseq.

تحقق: Check token in Logseq settings
vector_search فارغة

قم بتشغيل sync_vector_db أولاً؛ لم يتم المزامنة التلقائية.

تحقق: vector_db_status

البدائل

mcp-logseq مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Obsidian MCP (مجتمع)تستخدم Obsidian بدلاً من ذلكدلالات الرسم البياني مختلفة
Notion MCPأنت على NotionSaaS مدفوعة؛ نموذج رسم بياني مختلف
MCP نظام الملفات على مجلد Logseqتحتاج فقط إلى الوصول الخام للملفاتلا توجد عمليات على مستوى الكتلة، لا توجد استعلامات DSL

المزيد

الموارد

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

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

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