/ الدليل / الملعب / Zotero MCP
← كل الخوادم ↗ GitHub
● مجتمع 54yyyu 🔑 يتطلب مفتاحك

Zotero MCP

بواسطة 54yyyu · 54yyyu/zotero-mcp

Chat with your Zotero library — search 10k papers, pull citations, and extract note quotes without leaving Claude.

Zotero MCP connects Claude to your Zotero library (local or web). Every tool respects your existing collections and tags. Great for lit-review synthesis, citation management, and turning highlights into outlines.

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

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

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

عرض مباشر

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

zotero-mcp.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add zotero-mcp -- uvx zotero-mcp

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

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

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

Synthesize a literature review from tagged papers

👤 Grad students, researchers ⏱ ~60 min intermediate

متى تستخدمه: You've tagged 30 papers with #thesis-ch3 and need to write section 3.2.

المتطلبات الأساسية
  • Zotero running (local API enabled) — Zotero 7: Settings → Advanced → enable local API
  • API key if using web — zotero.org/settings/keys
الخطوات
  1. Pull the set
    List every item tagged thesis-ch3 in my Zotero. Just titles + years + first author.✓ تم النسخ
    → Clean inventory, ~30 items
  2. Cluster
    Group those by methodological approach. Cite each item by zotero key.✓ تم النسخ
    → 3–5 clusters with per-cluster citations
  3. Extract + write
    For cluster "quantitative RCTs", pull my highlights from each item and draft a synthesis paragraph with in-line citations.✓ تم النسخ
    → Paragraph with (Author, Year) citations backed by actual highlights

النتيجة: A drafted section 3.2 you can edit instead of starting from blank.

المزالق
  • PDF has no highlights, just scans — Run OCR in Zotero first (right-click → OCR PDF), then re-pull
اجمعها مع: filesystem

Generate the bibliography for a paper you're writing

👤 Anyone writing with LaTeX ⏱ ~15 min beginner

متى تستخدمه: You've cited 40 items across a draft and need a single references.bib.

الخطوات
  1. Scan for cites
    In /paper/main.tex, list every \cite{} key.✓ تم النسخ
    → All cite keys enumerated
  2. Resolve
    For each, pull BibTeX from Zotero and write the result to /paper/references.bib. Flag any key with no match.✓ تم النسخ
    → bib file written; unresolved cites listed

النتيجة: A clean references.bib tied to your Zotero — no manual copy-paste.

المزالق
  • Cite key mismatch (Better BibTeX vs default) — Install the Better BibTeX extension in Zotero for stable pinned keys
اجمعها مع: filesystem

التركيبات

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

zotero-mcp + filesystem

Write the extracted synthesis to your paper draft

Write the synthesis from Zotero into /paper/section-3-2.md.✓ تم النسخ
zotero-mcp + memory

Remember per-paper key arguments across sessions

Store the 1-sentence thesis of each item from cluster A in memory.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
search_items query: str, tag?: str, collection?: str Find items in library free
get_item key: str Inspect one item in depth free
get_annotations key: str Pull your highlights/notes on a PDF free
get_bibtex keys: str[] Build bibliography for a draft free
list_collections none Navigate your organization free

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

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

حصة API
Local API: unlimited. Web API: rate-limited by Zotero.
الرموز لكل استدعاء
Item metadata ~200 tokens; annotations can run large
التكلفة المالية
Free
نصيحة
Prefer search_items with tag filters over listing all items

الأمان

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

الحد الأدنى من الصلاحيات: library:read
تخزين بيانات الاعتماد: API key in env var (web mode only)
نقل البيانات الخارجي: api.zotero.org (web mode) or localhost (local mode)
لا تمنح أبدًا: library:write unless truly needed

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

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

ECONNREFUSED localhost:23119

Zotero isn't running, or local API is disabled. Open Zotero; Settings → Advanced → enable local API.

تحقق: `curl http://localhost:23119/api/users/0/items`
Web API 403

API key missing the library read scope. Regenerate at zotero.org/settings/keys.

BibTeX keys are auto-generated nonsense

Install Better BibTeX add-on and set a stable citekey format

البدائل

Zotero MCP مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Obsidian MCPYour notes live in Obsidian, not ZoteroDifferent data model — not paper-centric
Direct Zotero CSL exportOne-time export, no LLM involvementNo querying, no synthesis

المزيد

الموارد

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

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

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