Zotero MCP

🚀 Zotero MCP：您的研究資料室Claude

Zotero MCP是一款強大的工具，它能將Zotero與Claude等人工智能助手連接起來。藉助MCP協議，用戶可以輕鬆訪問和管理自己的研究資料，極大提升研究效率。

🚀 快速開始

Zotero MCP是一個將Zotero與Claude等人工智能助手連接起來的工具，使您能夠通過MCP協議訪問和管理您的研究資料。

✨ 主要特性

搜索功能

• 搜索資料室：可快速查找您的文獻資源。
• 高級搜索：支持複雜查詢條件，助力您精準定位所需內容。
• 收藏夾管理：能列出並查看所有收藏夾及其包含的文獻。
• 最近更新：可獲取最近添加到資料室的文獻。

內容訪問

• 元數據檢索：能獲取文獻的詳細信息，如標題、作者和出版年份。
• 全文獲取：在支持的情況下，可直接閱讀文獻的全文內容。
• 附件管理：可查看與文獻相關聯的所有附件和筆記。

註釋與筆記處理

• 註釋提取：可從PDF文件中直接提取手寫或文本註釋。
• 筆記檢索：能快速訪問您在Zotero中添加的所有筆記。
• 內容搜索：可在筆記和註釋中進行全文搜索，包括從PDF中提取的內容。
• 新建筆記：可為特定文獻創建新的批註（測試功能）。

靈活的接入方式

• 本地API使用：可通過Zotero的本地服務訪問資料室。
• Web API對接：支持遠程服務器上的資料室訪問，需提供相應的API密鑰和資料室ID。

📦 安裝指南

使用Smithery安裝

# 直接安裝並啟動服務
zotero-mcp setup

手動安裝（uv方式）

1. 下載源代碼：從項目倉庫克隆或下載。
2. 運行安裝腳本：

   uv zotero-mcp run
   

3. 啟動服務：

   zotero-mcp serve
   

通過pip安裝

pip install zotero-mcp

🔧 技術細節

高級配置

使用Web API代替本地API

zotero-mcp setup --no-local --api-key 您的API密鑰 --library-id 您的資料室ID

環境變量

• ZOTERO_LOCAL=true：使用本地Zotero服務（默認為false）。
• ZOTERO_API_KEY：您的Zotero Web API密鑰。
• ZOTERO_LIBRARY_ID：您要訪問的資料室ID。
• ZOTERO_LIBRARY_TYPE：資料室類型，可選值為user或group（默認為user）。

命令行選項

# 直接運行服務
zotero-mcp serve

# 指定傳輸方式
zotero-mcp serve --transport stdio|sse

# 獲取更多設置幫助
zotero-mcp setup --help

PDF註釋提取功能

Zotero MCP提供了強大的PDF註釋處理能力，包括：

• 直接PDF解析：無需依賴Zotero的索引功能，即可提取PDF中的手寫和文本註釋。
• 增強搜索：在註釋內容中進行全文搜索。
• 圖像註釋支持：識別並提取PDF中的圖像標註。
• 無縫集成：與Zotero的原生註釋系統完美兼容。

推薦：為了獲得最佳體驗，建議安裝Zotero Better BibTeX插件。此功能在插件環境下表現更佳。

💻 使用示例

基礎用法

以下是一些常用工具的使用示例：

# 搜索資料室中的文獻
zotero_search_items()

# 獲取文獻的詳細元數據
zotero_get_metadata()

高級用法

# 執行高級複雜查詢
zotero_advanced_search("複雜查詢條件")

# 從PDF中提取註釋內容
zotero_extract_annotations("pdf文件路徑")

📚 詳細文檔

可用工具集

搜索類工具

• zotero_search_items：搜索資料室中的文獻。
• zotero_advanced_search：執行高級複雜查詢。
• zotero_get_collections：獲取所有收藏夾列表。
• zotero_get_collection_items：查看特定收藏夾中的文獻。
• zotero_get_tags：列出所有標籤。
• zotero_get_recent：獲取最近添加的文獻。

內容訪問工具

• zotero_get_metadata：獲取文獻的詳細元數據。
• zotero_get_fulltext：在支持的情況下，獲取文獻全文內容。
• zotero_list_attachments：查看與文獻相關的附件列表。

註釋處理工具

• zotero_extract_annotations：從PDF中提取註釋內容。
• zotero_search_notes：在所有筆記和註釋中進行全文搜索。
• zotero_create_note：為特定文獻創建新的批註。

🛠️ 故障排除與支持

如遇問題，請訪問項目官網或加入用戶社區尋求幫助：

• 項目主頁：https://github.com/yourusername/zotero-mcp
• 用戶論壇：https://discussions.zotero.org

📄 許可證

本項目遵循MIT開源協議，具體條款請參考項目的LICENSE文件。