Zotero MCP Server

🚀 Zotero MCP 服務器

Zotero MCP 服務器是一個 MCP（模型上下文協議）服務器，它能讓 MCP 客戶端（如 Anthropic 的 Claude 應用、Goose，甚至 vscode Cline）與本地 Zotero 文獻庫實現交互。藉助這個服務器，你可以通過編程方式訪問 Zotero 圖書館，實現搜索論文、管理筆記等功能。

🚀 快速開始

📦 安裝指南

1. 安裝依賴項：

pip install -e .

2. 在根目錄下創建一個 .env 文件，包含你的 Zotero 憑據：

ZOTERO_API_KEY=your_api_key_here
ZOTERO_USER_ID=your_user_id_here

你可以在 Zotero 的設置頁面 獲取你的 Zotero API 密鑰和用戶 ID。

💻 使用示例

與 Anthropic Desktop 應用集成

要在 Anthropic Desktop 應用中進行集成，請將以下配置添加到 ~/Library/Application Support/Claude/claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "zotero-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/swairshah/work/research/zotero-mcp",
        "run",
        "python",
        "-m",
        "zotero_mcp.server"
      ]
    }
  }
}

⚠️ 重要提示

如果出現類似以下錯誤：

{"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"claude-ai","version":"0.1.0"}},"jsonrpc":"2.0","id":0}
  錯誤: 找到意外參數 '--directory'

請使用以下配置，並確保運行 uv venv; source .venv/bin/activate; uv pip install ".[dev]" 以確保服務器可以與所有依賴項一起運行。

{
   "mcpServers": {
      "zotero-mcp-server": {
        "command": "bash",
        "args": [
          "-c",
          "cd /Users/shahswai/personal/zotero-mcp-server && source .venv/bin/activate && python -m zotero_mcp.server"
        ]
      }
    }
  }

服務器功能示例

該服務器允許你：

• 按標籤搜索論文
• 獲取論文詳細信息和附加筆記
• 添加筆記到論文
• 請求論文摘要