/ 目錄 / 演練場 / zotero-mcp
● 社群 cookjohn ⚡ 即開即用

zotero-mcp

作者 cookjohn · cookjohn/zotero-mcp

讓 Claude 搜尋你的 Zotero 文庫、閱讀已儲存的 PDF,以及引用來源 — 以本機 Zotero 外掛程式執行,任何資料都不會離開你的機器。

zotero-mcp 是 Zotero 外掛程式(不是獨立伺服器),透過 Streamable HTTP 在連接埠 23120 公開約 20 個 MCP 工具。涵蓋搜尋、語意配對、註解擷取,以及本機文庫的寫入作業。因為它內建在 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 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

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

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "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

何時使用: 你在 Zotero 中收集了某個主題的 50 篇以上論文,並需要將其整合成連貫的回顧。

前置條件
  • 已安裝 zotero-mcp 外掛程式的 Zotero 桌面版 — 從版本下載 .xpi,工具 → 附加元件 → 從檔案安裝
  • 已附加和索引的 PDF — 若搜尋為空,右鍵點擊收藏 → 重建全文索引
步驟
  1. 確定回顧範圍
    在我的 Zotero 收藏「Agentic AI」中語意搜尋有關工具選擇策略的論文。傳回前 15 個。✓ 已複製
    → 具有標題、作者、年份、摘要片段的排名清單
  2. 從每篇論文中提取關鍵主張
    對於那 15 篇論文,各讀取全文並提取 (a) 主要主張、(b) 方法、(c) 資料集或設置。✓ 已複製
    → 你可以排序的結構化表格
  3. 綜合引用內容
    寫一篇 3 頁的回顧,按方法群集這些論文。用 (Author, Year) 風格的 Zotero 項目鑰匙引用每個主張。✓ 已複製
    → 具有括號引用的草稿,映射回你的文庫

結果: 以你實際擁有的論文為基礎的初稿回顧,每個主張都可以追蹤到 Zotero 項目。

注意事項
  • 全文搜尋傳回無結果 — Zotero 只索引具有文字圖層的 PDF。先對影像 PDF 執行 OCR
  • 引用被虛構 — 要求在每個引用旁邊提供 Zotero 項目鑰匙(例如 ABCD1234) — 你可以將其貼到驗證工具中
搭配使用: arxiv

總結你在 Zotero 收藏中的亮點

👤 熱心讀者、知識工作者 ⏱ ~20 min beginner

何時使用: 你在 30 本書籍/論文中標記了內容,並想要主題摘要。

步驟
  1. 按顏色/標籤拉取註解
    在「產品戰略」收藏中搜尋我的黃色標記。傳回標記的文字加上父項目。✓ 已複製
    → 按來源分組的亮點清單
  2. 群集成主題
    將亮點群集為 5-7 個主題。對於每個主題,提供 2 句綜合說明和來源項目。✓ 已複製
    → 帶引用的主題筆記

結果: 分散的亮點轉變為個人知識庫筆記。

搭配使用: anytype

自動標籤和註解新增的 Zotero 論文

👤 文庫維護人員 ⏱ ~15 min intermediate

何時使用: 你將論文放入「未分類」收藏中,並想每週進行分類。

步驟
  1. 列出本週在「未分類」中新增的項目
    列出在過去 7 天內新增到我的「未分類」收藏的 Zotero 項目。✓ 已複製
    → 新項目的收件匣
  2. 為每個項目生成標籤和 1 行摘要
    對於每個項目,根據摘要提議 3-5 個標籤和 1 行摘要。透過寫入工具應用它們。✓ 已複製
    → 項目現已標籤化;摘要已保存為筆記附件

結果: 具有一致標籤的自我維護 Zotero 文庫。

注意事項
  • 寫入工具不可逆地修改你的文庫 — 無法撤銷 — 先針對測試收藏執行,或在啟用寫入前備份 zotero.sqlite

組合

與其他 MCP 搭配,撬動十倍槓桿

zotero + arxiv

Arxiv-first 探索,然後自動儲存到 Zotero 以供閱讀

找到 10 篇最近有關檢索增強代理的 arxiv 論文,然後將我還沒有的論文新增到我的「Agents」Zotero 收藏中。✓ 已複製
zotero + anytype

文獻筆記位於 Anytype;來源 PDF 保留在 Zotero 中

對於我的「Agents」收藏中的前 10 篇論文,為每篇論文建立一個 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 配額
無 — 完全本機
每次呼叫 Token 數
完整 PDF 擷取可能達到 30k+ 個權杖;在輸入前分段
費用
免費(Zotero 免費;外掛程式採用 MIT)
提示
更傾向使用傳回片段的 search_fulltext 而不是傳回整個 PDF 的 get_content

安全

權限、密鑰、影響範圍

憑證儲存: 無 — 外掛程式在 Zotero 內執行;本機 HTTP 在 127.0.0.1:23120
資料出站: 讀取模式下無;寫入在本機修改 zotero.sqlite

故障排查

常見錯誤與修復

MCP 用戶端無法連接到連接埠 23120

開啟 Zotero → 偏好設定 → Zotero MCP 外掛程式 → 驗證已勾選「啟用伺服器」且連接埠未被阻止

驗證: curl http://127.0.0.1:23120/health
全文搜尋傳回空結果

PDF 沒有文字圖層。右鍵點擊項目 → 重新索引項目,或透過 Zotero 的內建 OCR 執行 OCR

寫入作業被禁止

在外掛程式偏好設定中啟用寫入模式 — 預設關閉以確保安全

替代方案

zotero-mcp 對比其他方案

替代方案何時用它替代權衡
Official Zotero Web API你需要從遠端���服器存取雲端同步需要 API 鑰匙;速率受限;無語意搜尋
Readwise MCP你的亮點位於 Readwise 而不是 Zotero雲端式,需要訂閱

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills