Zotero

🚀 Zotero MCP 連接器

這是一個用於將本地 Zotero 與 Claude 集成的模型控制協議 (MCP) 連接器。藉助它，您可以通過 Claude 的桌面界面直接訪問本地 Zotero 圖書館。該連接器依賴於 Zotero 7 中本地 Web API 的可用性。

🚀 快速開始

本項目受到使用 Node.js 和 Web API 的 mcp - zotero 倉庫的啟發，並且基於出色的 pyzotero 庫構建。

✨ 主要特性

• 實現本地 Zotero 與 Claude 的集成，可通過 Claude 桌面界面直接訪問本地 Zotero 圖書館。
• 提供多種功能，如列出集合、獲取集合項目、查看論文詳情、搜索圖書館以及獲取最近添加的論文等。

📦 安裝指南

有關 Claude Desktop 如何與 MCP 交互的信息，請參閱 here。

1. 使用 uv。安裝說明請訪問 here。
2. 將項目克隆到本地並激活虛擬環境：

git clone https://github.com/gyger/mcp-pyzotero.git
cd mcp-pyzotero
uv sync

3. 在 Zotero 7 中啟用本地 API：
4. 將服務器添加到您的本地 Claude 安裝中：

uv run mcp install zotero.py

📚 詳細文檔

配置

連接器配置為與本地 Zotero 安裝一起使用，目前僅支持 user 圖書館。默認情況下，它使用用戶 ID 0，但您也可以通過設置環境變量 ZOTERO_USER_ID 來指定：

uv run mcp install zotero.py -v ZOTERO_USER_ID=0

可用功能

連接器提供以下功能：

• get_collections(): 列出您的 Zotero 圖書館中的所有集合
• get_collection_items(collection_key): 獲取特定集合中的所有項目
• get_item_details(item_key): 獲取特定論文的詳細信息，包括摘要
• search_library(query): 搜索整個 Zotero 圖書館
• get_recent(limit = 10): 獲取最近添加到圖書館的論文

未來計劃擴展此功能。

要求

• Python 3.10+
• 本地 Zotero 安裝
• Claude Desktop

貢獻

歡迎貢獻！請訪問 GitHub 倉庫：

• 報告問題
• 提交拉取請求
• 建議改進

📄 許可證

本項目採用 MIT 許可證。