/ الدليل / الملعب / zotero-mcp
← كل الخوادم ↗ GitHub
● مجتمع cookjohn ⚡ فوري

zotero-mcp

بواسطة cookjohn · cookjohn/zotero-mcp

اسمح لـ Claude بالبحث في مكتبتك Zotero وقراءة ملفات PDF المحفوظة والاستشهاد بالمصادر — يعمل كمكون إضافي محلي في Zotero، لا تغادر البيانات جهازك.

zotero-mcp هو مكون إضافي في Zotero (وليس خادم منفصل) يفتح حوالي 20 أداة MCP عبر HTTP Streamable على المنفذ 23120. يغطي البحث والمطابقة الدلالية واسترجاع التعليقات التوضيحية والعمليات الكتابية على مكتبتك المحلية. لأنه يتم شحنه داخل Zotero، لا تحتاج ملفات PDF أبداً إلى إعادة تحميل.

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

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

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

عرض مباشر

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

zotero.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add zotero -- npx -y zotero-mcp

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

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

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

كيفية صياغة مراجعة الأدبيات من مكتبة Zotero الخاصة بك

👤 الباحثون وطلاب الدكتوراه والمحللون ⏱ ~45 min intermediate

متى تستخدمه: لقد جمعت 50+ ورقة بحثية حول موضوع في Zotero وتحتاج إلى تجميعها في مراجعة متماسكة.

المتطلبات الأساسية
  • Zotero سطح المكتب مع تثبيت مكون إضافي zotero-mcp — قم بتحميل .xpi من الإصدارات، Tools → Add-ons → Install from file
  • ملفات PDF مرفقة ومفهرسة — انقر بزر الماوس الأيمن على المجموعة → Rebuild Full-Text Index إذا كان البحث فارغاً
الخطوات
  1. تحديد نطاق المراجعة
    ابحث دلالياً في مجموعة Zotero الخاصة بي 'Agentic AI' عن أوراق حول استراتيجيات اختيار الأدوات. أرجع أفضل 15.✓ تم النسخ
    → قائمة مرتبة مع العناوين والمؤلفين والسنة وجزء المستخلص
  2. استخراج الادعاءات الرئيسية لكل ورقة
    لكل من تلك الـ 15، اقرأ النص الكامل واستخرج (أ) الادعاء الرئيسي، (ب) الطريقة، (ج) مجموعة البيانات أو الإعداد.✓ تم النسخ
    → جدول منظم يمكنك ترتيبه
  3. التجميع مع الاستشهادات
    اكتب مراجعة من 3 صفحات تجمع هذه حسب الأسلوب. استشهد بكل ادعاء مع مفاتيح عناصر Zotero بنمط (Author, Year).✓ تم النسخ
    → مسودة مع استشهادات في قوسين معقوفة ترسم خريطة إلى مكتبتك

النتيجة: مراجعة المسودة الأولى المستندة إلى الأوراق التي تمتلكها فعلاً، كل ادعاء يمكن تتبعه إلى عنصر Zotero.

المزالق
  • البحث الكامل لا يعيد شيء — Zotero يفهرس فقط نصوص PDF. قم بتشغيل OCR على ملفات PDF الصور أولاً
  • الاستشهادات مختلقة — اطلب مفتاح عنصر Zotero (مثل ABCD1234) مع كل استشهاد — يمكنك لصقه في أداة التحقق
اجمعها مع: arxiv

قم بتلخيص أبرز نقاطك عبر مجموعة Zotero

👤 القراء المتعطشون، العاملون في المعرفة ⏱ ~20 min beginner

متى تستخدمه: لقد أبرزت أشياء عبر 30 كتاب/ورقة وتريد ملخصاً موضوعياً.

الخطوات
  1. سحب التعليقات التوضيحية حسب اللون/العلامة
    ابحث عن أبرز نقاطي الصفراء في مجموعة 'Product Strategy'. أرجع النص المبرز بالإضافة إلى العنصر الأصلي.✓ تم النسخ
    → قائمة الأبرز مجمعة حسب المصدر
  2. تجميع في الموضوعات
    جميع الأبرز في 5-7 موضوعات. لكل موضوع، أعطِ تجميعاً من جملتين مع العناصر المصدرية.✓ تم النسخ
    → ملاحظات موضوعية مع استشهادات

النتيجة: أبرز مشتتة تحولت إلى ملاحظة قاعدة معرفة شخصية.

اجمعها مع: anytype

وسم وتعليق تلقائياً على أوراق Zotero المضافة حديثاً

👤 محافظو المكتبة ⏱ ~15 min intermediate

متى تستخدمه: تضع أوراق في مجموعة 'غير مرتبة' وتريدها فرزها أسبوعياً.

الخطوات
  1. قائمة العناصر المضافة هذا الأسبوع في 'غير مرتبة'
    قائمة بعناصر Zotero المضافة في آخر 7 أيام إلى مجموعتي 'غير مرتبة'.✓ تم النسخ
    → صندوق الوارد للعناصر الجديدة
  2. إنشاء علامات وملخص بسطر واحد لكل عنصر
    لكل منها، اقترح 3-5 علامات وملخص بسطر واحد بناءً على المستخلص. طبقها عبر أدوات الكتابة.✓ تم النسخ
    → العناصر الآن مع علامات؛ الملخص محفوظ كمرفق ملاحظة

النتيجة: مكتبة Zotero تحافظ على نفسها بنفسها مع وسم متسق.

المزالق
  • أدوات الكتابة تعدل مكتبتك بشكل لا رجعة فيه — لا توجد خاصية تراجع — قم بالتشغيل على مجموعة اختبار أولاً، أو انسخ احتياطياً zotero.sqlite قبل تفعيل الكتابة

التركيبات

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

zotero + arxiv

استكشاف Arxiv أولاً ثم حفظ تلقائي إلى Zotero للقراءة

أوجد 10 أوراق arxiv حديثة حول الوكلاء المعززين بالاسترجاع، ثم أضف تلك التي لا أملكها بالفعل إلى مجموعتي 'Agents' في Zotero.✓ تم النسخ
zotero + anytype

ملاحظات الأدبيات تعيش في Anytype؛ ملفات PDF المصدر تبقى في Zotero

لأفضل 10 أوراق في مجموعتي 'Agents'، أنشئ صفحة Anytype لكل ورقة مع الملخص ورابط خلفي لمفتاح عنصر Zotero.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
search_library query: str, filters?: { collection, tag, itemType } البحث في النصوص/البيانات الوصفية عبر مكتبتك 0 — local DB
search_fulltext query: str البحث داخل أجسام PDF (فقط طبقات النصوص المفهرسة) 0
semantic_search query: str, top_k?: int المطابقة على مستوى المفهوم بدلاً من الكلمة الرئيسية 0 — local embeddings
search_annotations color?, tag?, query? سحب أبرزك/ملاحظاتك 0
get_item_details item_key: str توسيع مرجع من نتيجة بحث 0
get_content item_key or attachment_key تغذية الورقة الكاملة إلى Claude 0

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

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

حصة API
لا شيء — محلي بالكامل
الرموز لكل استدعاء
قد تصل جلسات PDF الكاملة إلى 30 ألف + رموز؛ قسم قبل التغذية
التكلفة المالية
مجاني (Zotero مجاني؛ المكون الإضافي MIT)
نصيحة
فضّل search_fulltext الذي يعيد مقاطع على get_content الذي يعيد PDF بالكامل

الأمان

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

تخزين بيانات الاعتماد: لا شيء — يعمل المكون الإضافي داخل Zotero؛ HTTP محلي على 127.0.0.1:23120
نقل البيانات الخارجي: لا شيء في وضع القراءة؛ الكتابة تعدل zotero.sqlite محلياً

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

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

لا يمكن لعميل MCP الاتصال على المنفذ 23120

افتح Zotero → Preferences → Zotero MCP Plugin → تحقق من أن 'Enable server' مختار والمنفذ غير محظور

تحقق: curl http://127.0.0.1:23120/health
البحث الكامل يعيد فارغاً

PDF ليس لديه طبقة نصوص. انقر بزر الماوس الأيمن على العنصر → Reindex Item، أو قم بتشغيل OCR عبر OCR المدمج في Zotero

عمليات الكتابة محظورة

تفعيل وضع الكتابة في تفضيلات المكون الإضافي — معطل افتراضياً لأسباب الأمان

البدائل

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

البديلمتى تستخدمهاالمقايضة
Official Zotero Web APIتحتاج إلى الوصول المتزامن السحابي من خادم بعيديتطلب مفتاح API؛ محدود بالسعر؛ بدون بحث دلالي
Readwise MCPأبرزك تعيش في Readwise وليس Zoteroقائم على السحابة، يتطلب اشتراك

المزيد

الموارد

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

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

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