54yyyu/zotero-mcp 是什麼？

以 README、倉庫資料與版本資訊整理 54yyyu/zotero-mcp 的實際能力、操作入口和未說明限制。

54yyyu/zotero-mcp 可以商用嗎？

可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。

54yyyu/zotero-mcp 還在維護嗎？

有在維護。儲存庫最近一次提交在 1 天前。

54yyyu/zotero-mcp 是用什麼程式語言寫的？

主要是 Python（依據 GitHub 的語言統計）。

54yyyu/zotero-mcp：功能、設定與採用前核驗

秒懂

它是什麼？: 以 README、倉庫資料與版本資訊整理 54yyyu/zotero-mcp 的實際能力、操作入口和未說明限制。
適合誰用？: 適合需要 54yyyu/zotero-mcp 所處理工作、且能依 README 指定的命令與文件維護環境的人；不適合把倉庫描述直接當成安全、效能或相容性保證的人。先以 zotero-mcp 以 MCP 工具連接 Zotero 文庫；設定檔、Zotero API、collection 查詢和引用輸出是判斷權限與資料邊界的具體觀察點。
可以商用嗎？: 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
還在維護嗎？: 有在維護。儲存庫最近一次提交在 1 天前。
用什麼語言寫的？: 主要是 Python（依據 GitHub 的語言統計）。

以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。

開源專案深度解析

Hysen Labs 編輯部 · 2026年8月8日 · 54yyyu/zotero-mcp

專案概覽

Zotero MCP是一個Python伺服器，可將Zotero研究文獻庫連接到支援Model Context Protocol的AI助手。README中列舉了Claude、ChatGPT、Cherry Studio和Chorus作為相容用戶端。它提供工具用於搜尋文獻庫、取得條目中繼資料和全文、擷取PDF註解，以及執行寫入操作，例如透過DOI或URL新增論文。倉庫中繼資料將語言列為Python，截至中繼資料快照，有4,544個星標、370個分叉和50個未解決問題。專案首頁指向https://stevenyuyy.com/zotero-mcp/。授權為MIT。

在「專案概覽」這個面向，54yyyu/zotero-mcp 不能只看功能名稱。README 明列的 zotero-mcp 以 MCP 工具連接 Zotero 文庫；設定檔、Zotero API、collection 查詢和引用輸出是判斷權限與資料邊界的具體觀察點。讓使用者可以把第 1 項檢查拆成可觀察的步驟：先確認輸入是否被正確接受，再記錄產物、日誌或介面狀態，最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾，本文不替它補上結論。

「專案概覽」也會受到版本與環境影響。倉庫資料記錄的預設分支是 main，最近版本為 v0.11.0；這些是來源快照，不是效能保證。若要採用，應以同一版本重跑上述專案命令，觀察 54yyyu/zotero-mcp 在第 1 項測試中的輸出，而不是以 star、fork 或作者形容詞代替證據。

安裝與選用擴充

README推薦使用uv安裝：`uv tool install zotero-mcp-server`，然後執行`zotero-mcp setup`。pip和pipx安裝也有相同步驟的文件。基礎套件包含搜尋、中繼資料擷取、註解和寫入操作，不包含機器學習依賴。重元件拆分為選用擴充：`semantic`新增ChromaDB、sentence-transformers和OpenAI或Gemini嵌入；`pdf`新增PyMuPDF用於PDF大綱擷取和EPUB註解支援；`scite`啟用Scite引文統計和撤稿檢查。`all`擴充安裝所有內容。更新命令為`zotero-mcp update`，使用`--check-only`可僅檢查而不安裝。

在「安裝與選用擴充」這個面向，54yyyu/zotero-mcp 不能只看功能名稱。README 明列的 zotero-mcp 以 MCP 工具連接 Zotero 文庫；設定檔、Zotero API、collection 查詢和引用輸出是判斷權限與資料邊界的具體觀察點。讓使用者可以把第 2 項檢查拆成可觀察的步驟：先確認輸入是否被正確接受，再記錄產物、日誌或介面狀態，最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾，本文不替它補上結論。

「安裝與選用擴充」也會受到版本與環境影響。倉庫資料記錄的預設分支是 main，最近版本為 v0.11.0；這些是來源快照，不是效能保證。若要採用，應以同一版本重跑上述專案命令，觀察 54yyyu/zotero-mcp 在第 2 項測試中的輸出，而不是以 star、fork 或作者形容詞代替證據。

設定：本機、Web與混合存取

伺服器可透過本機API或Web API連接Zotero。本機模式需要在Zotero偏好設定中啟用「允許其他應用程式在此電腦上與Zotero通訊」，且為唯讀；寫入操作在提供憑證時透過Web API執行。設定`ZOTERO_LOCAL=true`並配合API金鑰和庫ID，伺服器將以混合模式執行：本機讀取，Web API寫入。對於遠端設定，`zotero-mcp setup --no-local --api-key ... --library-id ...`設定僅Web存取。環境變數涵蓋連接細節，包括用於群組庫的`ZOTERO_LIBRARY_TYPE`和用於附件下載的WebDAV憑證。README指出，shell環境變數會覆蓋用戶端設定檔中的值。

在「設定：本機、Web與混合存取」這個面向，54yyyu/zotero-mcp 不能只看功能名稱。README 明列的 zotero-mcp 以 MCP 工具連接 Zotero 文庫；設定檔、Zotero API、collection 查詢和引用輸出是判斷權限與資料邊界的具體觀察點。讓使用者可以把第 3 項檢查拆成可觀察的步驟：先確認輸入是否被正確接受，再記錄產物、日誌或介面狀態，最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾，本文不替它補上結論。

「設定：本機、Web與混合存取」也會受到版本與環境影響。倉庫資料記錄的預設分支是 main，最近版本為 v0.11.0；這些是來源快照，不是效能保證。若要採用，應以同一版本重跑上述專案命令，觀察 54yyyu/zotero-mcp 在第 3 項測試中的輸出，而不是以 star、fork 或作者形容詞代替證據。

語意搜尋與文字擷取

語意搜尋是選用功能，需要`semantic`擴充。它使用向量相似性搜尋文獻庫，嵌入模型可選用預設本機模型（all-MiniLM-L6-v2）、OpenAI、Gemini或Ollama。設定在`zotero-mcp setup`期間或透過`zotero-mcp setup --semantic-config-only`完成。索引透過`zotero-mcp update-db`建置，預設僅中繼資料索引；`--fulltext`包含全文但速度較慢。其他旗標包括`--force-rebuild`、`--db-path`和用於透過OpenAI Batch API提交嵌入的`--openai-batch`。文字擷取設定位於`~/.config/zotero-mcp/config.json`中的`semantic_search.extraction`，鍵如`pdf_max_pages`和`attachment_priority`。README說明提高`pdf_max_pages`不會超出嵌入模型的token限制來擴大搜尋召回。

在「語意搜尋與文字擷取」這個面向，54yyyu/zotero-mcp 不能只看功能名稱。README 明列的 zotero-mcp 以 MCP 工具連接 Zotero 文庫；設定檔、Zotero API、collection 查詢和引用輸出是判斷權限與資料邊界的具體觀察點。讓使用者可以把第 4 項檢查拆成可觀察的步驟：先確認輸入是否被正確接受，再記錄產物、日誌或介面狀態，最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾，本文不替它補上結論。

「語意搜尋與文字擷取」也會受到版本與環境影響。倉庫資料記錄的預設分支是 main，最近版本為 v0.11.0；這些是來源快照，不是效能保證。若要採用，應以同一版本重跑上述專案命令，觀察 54yyyu/zotero-mcp 在第 4 項測試中的輸出，而不是以 star、fork 或作者形容詞代替證據。

工具面與工具集

伺服器註冊的每個工具都會在每次請求時傳送給模型，因此README描述了固定的上下文視窗開銷。為保持比例，選用功能被分組為工具集，由`ZOTERO_MCP_TOOLSETS`控制。預設設定包含核心工具以及`libraries`、`search-admin`和`pdf-geometry`。諸如`scite`、`duplicates`、`discovery`、`feeds`、`relations`和`chatgpt-connector`等組預設關閉或根據傳輸方式自動啟用。停用工具是真正不存在，而非隱藏。README列出了諸如`zotero_search_items`、`zotero_get_item_metadata`、`zotero_add_by_doi`和`zotero_manage_note`等工具。工具可用性取決於啟動的工具集。

在「工具面與工具集」這個面向，54yyyu/zotero-mcp 不能只看功能名稱。README 明列的 zotero-mcp 以 MCP 工具連接 Zotero 文庫；設定檔、Zotero API、collection 查詢和引用輸出是判斷權限與資料邊界的具體觀察點。讓使用者可以把第 5 項檢查拆成可觀察的步驟：先確認輸入是否被正確接受，再記錄產物、日誌或介面狀態，最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾，本文不替它補上結論。

「工具面與工具集」也會受到版本與環境影響。倉庫資料記錄的預設分支是 main，最近版本為 v0.11.0；這些是來源快照，不是效能保證。若要採用，應以同一版本重跑上述專案命令，觀察 54yyyu/zotero-mcp 在第 5 項測試中的輸出，而不是以 star、fork 或作者形容詞代替證據。

CLI模式與測試

套件內包含`zotero-cli`，一個獨立的終端用戶端，使用與MCP伺服器相同的設定，但不需要AI助手。它支援搜尋、中繼資料擷取、筆記和註解、新增條目、管理收藏集和重複偵測。README中的範例展示了短別名，如`s`用於搜尋，`ann`用於註解。對於測試，倉庫包含單元測試，使用`uv run pytest tests/`執行（README列出了294個測試），以及一份45點即時整合測試計畫，位於`docs/integration-test-plan.md`，設計用於在Claude Desktop中交給Claude執行。

在「CLI模式與測試」這個面向，54yyyu/zotero-mcp 不能只看功能名稱。README 明列的 zotero-mcp 以 MCP 工具連接 Zotero 文庫；設定檔、Zotero API、collection 查詢和引用輸出是判斷權限與資料邊界的具體觀察點。讓使用者可以把第 6 項檢查拆成可觀察的步驟：先確認輸入是否被正確接受，再記錄產物、日誌或介面狀態，最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾，本文不替它補上結論。

「CLI模式與測試」也會受到版本與環境影響。倉庫資料記錄的預設分支是 main，最近版本為 v0.11.0；這些是來源快照，不是效能保證。若要採用，應以同一版本重跑上述專案命令，觀察 54yyyu/zotero-mcp 在第 6 項測試中的輸出，而不是以 star、fork 或作者形容詞代替證據。

編輯結論

適合需要 54yyyu/zotero-mcp 所處理工作、且能依 README 指定的命令與文件維護環境的人；不適合把倉庫描述直接當成安全、效能或相容性保證的人。先以 zotero-mcp 以 MCP 工具連接 Zotero 文庫；設定檔、Zotero API、collection 查詢和引用輸出是判斷權限與資料邊界的具體觀察點。建立隔離測試，確認輸入、輸出、權限與失敗訊息，再決定是否納入正式流程。

官方來源

社群筆記