Zotero MCP Server

🚀 Zotero MCP 服務器

Zotero MCP 服務器是一個集成到 Zotero 的 Model Context Protocol (MCP) 服務器，它為 AI 應用程序提供了訪問和操作 Zotero 圖書館的能力，極大地拓展了 Zotero 的應用場景。

✨ 主要特性

• 搜索功能：可在 Zotero 圖書館中搜索項目。
• 引文獲取：能夠獲取引文和 bibliography。
• 項目添加：支持向 Zotero 圖書館添加新項目。
• 資源訪問：允許訪問集合和項目。
• 多類型支持：同時支持個人和組圖書館。

📦 安裝指南

克隆倉庫

git clone https://github.com/your-username/zotero-mcp-server.git
cd zotero-mcp-server

創建虛擬環境

python -m venv venv

激活虛擬環境

• Linux/macOS 系統：

source venv/bin/activate

• Windows 系統：

venv\Scripts\activate

安裝依賴項

pip install -r requirements.txt

📚 詳細文檔

配置步驟

複製示例環境文件

cp .env.example .env

編輯 .env 文件

ZOTERO_API_KEY=your_api_key_here
ZOTERO_USER_ID=your_numeric_user_id_here
# ZOTERO_GROUP_ID=your_group_id_here  # 解注以使用組圖書館

你需要設置 ZOTERO_USER_ID（用於個人圖書館）或 ZOTERO_GROUP_ID（用於組圖書館）。

查找 Zotero 用戶 ID

如果你不確定如何找到你的 Zotero 用戶 ID，請運行：

./find_zotero_id.py

使用說明

運行服務器

python src/server.py

服務器將啟動並監聽標準輸入/輸出上的 JSON-RPC 請求。

測試服務器

./simple_test.py

這將運行一系列測試以驗證服務器是否正常工作。

與 AI 應用程序集成

Zotero MCP 服務器可以與支持 Model Context Protocol 的 AI 應用程序集成。請參閱 USAGE_GUIDE.md 文件獲取詳細示例。

可用資源

可用工具

其他文檔資源

有關更多詳細信息，請參閱：

• USAGE_GUIDE.md：詳細的使用指南
• test_client.py：交互式測試客戶端
• simple_test.py：簡單的測試腳本
• find_zotero_id.py：幫助查找你的 Zotero ID 的腳本

📄 許可證

本項目採用 MIT 許可證。

💪 貢獻

歡迎大家貢獻代碼！請隨意提交 Pull Request。