Zotero MCP

為什麼要用

核心特性

依作者、標題、標籤、分類、全文搜尋
取得任何條目的 BibTeX／CSL-JSON
從 PDF 附件中擷取標注和注釋
相容 Zotero 7 本機 API 和 Zotero Web API
預設唯讀——可安全掛載到你的研究書庫

即時演示

實際使用效果

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 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "zotero-mcp": {
      "command": "uvx",
      "args": [
        "zotero-mcp"
      ]
    }
  }
}

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

從帶標籤的論文中合成文獻綜述

👤 研究生、研究人員 ⏱ ~60 min intermediate

何時使用： 你已將 30 篇論文標記為 #thesis-ch3，現在需要撰寫第 3.2 節。

前置條件

Zotero 正在執行（本機 API 已啟用） — Zotero 7：設定 → 進階 → 啟用本機 API
若使用網頁版則需要 API 金鑰 — zotero.org/settings/keys

步驟

取得集合

List every item tagged thesis-ch3 in my Zotero. Just titles + years + first author.✓ 已複製

→ 清晰的盤點清單，約 30 筆
分群

Group those by methodological approach. Cite each item by zotero key.✓ 已複製

→ 3–5 個群組，各附有引用
擷取並撰寫

For cluster "quantitative RCTs", pull my highlights from each item and draft a synthesis paragraph with in-line citations.✓ 已複製

→ 段落附有「（作者, 年份）」格式的引用，以實際標注為依據

結果： 一份第 3.2 節草稿，讓你可以直接編輯而不是從空白開始。

注意事項

PDF 沒有標注，只有掃描 — 先在 Zotero 執行 OCR（右鍵 → OCR PDF），再重新取得

搭配使用： filesystem

為你正在撰寫的論文生成參考書目

👤 使用 LaTeX 寫作的任何人 ⏱ ~15 min beginner

何時使用： 你在草稿中引用了 40 筆條目，需要一個完整的 references.bib。

步驟

掃描引用

In /paper/main.tex, list every \cite{} key.✓ 已複製

→ 所有引用鍵列舉完畢
解析

For each, pull BibTeX from Zotero and write the result to /paper/references.bib. Flag any key with no match.✓ 已複製

→ bib 檔案已寫入；未解析的引用已標記

結果： 一個與你 Zotero 書庫連動的乾淨 references.bib——無需手動複製貼上。

注意事項

引用鍵不匹配（Better BibTeX 與預設格式） — 在 Zotero 安裝 Better BibTeX 擴充功能，設定穩定的固定引用鍵格式

搭配使用： filesystem

組合

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

zotero-mcp + filesystem

將擷取的綜述寫入論文草稿

Write the synthesis from Zotero into /paper/section-3-2.md.✓ 已複製

zotero-mcp + memory

跨 session 記住各篇論文的核心論點

Store the 1-sentence thesis of each item from cluster A in memory.✓ 已複製

工具

此 MCP 暴露的能力

工具	輸入參數	何時呼叫	成本
search_items	query: str, tag?: str, collection?: str	在書庫中尋找條目	free
get_item	key: str	深入檢視某一筆條目	free
get_annotations	key: str	取得你在 PDF 上的標注和筆記	free
get_bibtex	keys: str[]	為草稿建立參考書目	free
list_collections	none	瀏覽你的分類結構	free

成本與限制

運行它的成本

API 配額: 本機 API：無限制。Web API：受 Zotero 速率限制。
每次呼叫 Token 數: 條目中繼資料約 200 tokens；標注可能較多
費用: 免費
提示: 優先使用帶標籤篩選的 search_items，而非列出所有條目

安全

權限、密鑰、影響範圍

最小權限： library:read

憑證儲存： API 金鑰以環境變數儲存（僅限網頁模式）

資料出站： api.zotero.org（網頁模式）或 localhost（本機模式）

切勿授予： library:write unless truly needed

故障排查

常見錯誤與修復

ECONNREFUSED localhost:23119

Zotero 未執行，或本機 API 已停用。開啟 Zotero；設定 → 進階 → 啟用本機 API。

驗證： `curl http://localhost:23119/api/users/0/items`

Web API 403

API 金鑰缺少書庫讀取範圍。至 zotero.org/settings/keys 重新生成。

BibTeX keys are auto-generated nonsense

安裝 Better BibTeX 附加元件，並設定穩定的引用鍵格式

替代方案

Zotero MCP 對比其他方案

替代方案	何時用它替代	權衡
Obsidian MCP	你的筆記存放在 Obsidian，而非 Zotero	資料模型不同——不是以論文為中心
Direct Zotero CSL export	一次性匯出，不需要 LLM 參與	無法查詢，也無法合成

為什麼要用

核心特性

即時演示

實際使用效果

安裝

選擇你的客戶端

使用場景

實戰用法： Zotero MCP

從帶標籤的論文中合成文獻綜述

前置條件

步驟

注意事項

為你正在撰寫的論文生成參考書目

步驟

注意事項

組合

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

工具

此 MCP 暴露的能力

成本與限制

運行它的成本

安全

權限、密鑰、影響範圍

故障排查

常見錯誤與修復

替代方案

Zotero MCP 對比其他方案

更多

資源