MCP Zotero

🚀 MCP Zotero 服務器

這是一個用於 Zotero 整合的 Model Context Protocol 服務器，它能夠讓 Claude 與你的 Zotero 圖書館進行交互，為文獻管理和信息檢索帶來便利。

🚀 快速開始

📦 安裝指南

按照以下步驟完成服務器的設置：

1. 獲取 Zotero 憑證：

   # 首先，在 https://www.zotero.org/settings/keys 創建一個 API 密鑰
   # 然後使用它來獲取你的用戶 ID：
   curl -H "Zotero-API-Key: YOUR_API_KEY" https://api.zotero.org/keys/current
   

   響應示例如下：

   {
     "userID": 123456,
     "username": "your_username",
     "access": {
       "user": {
         "library": true,
         "files": true,
         "notes": true,
         "write": true
       }
     }
   }
   

   你需要記錄 userID 的值。

2. 設置環境變量：

   export ZOTERO_API_KEY="your-api-key"
   export ZOTERO_USER_ID="user-id-from-curl"
   

3. 驗證憑證：

   # 測試你的憑證是否有效：
   curl -H "Zotero-API-Key: $ZOTERO_API_KEY" \
        "https://api.zotero.org/users/$ZOTERO_USER_ID/collections"
   

   若看到集合列表響應，則說明憑證有效。

4. 安裝並運行：

   • 全局安裝（推薦）：

   npm install -g mcp-zotero
   mcp-zotero
   

   • 使用 npx 運行：

   npx mcp-zotero
   

💻 使用示例

與 Claude Desktop 集成

要將此服務器與 Claude Desktop 集成，請在你的 Claude Desktop 配置中添加以下內容：

{
  "mcpServers": {
    "zotero": {
      "command": "mcp-zotero",
      "env": {
        "ZOTERO_API_KEY": YOUR_API_KEY,
        "ZOTERO_USER_ID": YOUR_USER_ID
      }
    }
  }
}

✨ 主要特性

本服務器提供了以下可用工具：

• get_collections：列出圖書館中的所有集合
• get_collection_items：獲取特定集合中的項目
• get_item_details：獲取論文的詳細信息
• search_library：搜索整個圖書館
• get_recent：獲取最近添加的論文

🔧 故障排除

如果遇到任何問題，可以按照以下步驟進行排查：

1. 驗證環境變量設置：

   echo $ZOTERO_API_KEY
   echo $ZOTERO_USER_ID
   

2. 檢查安裝情況：

   npm list -g mcp-zotero
   

3. 嘗試重新安裝：

   npm uninstall -g mcp-zotero
   npm install -g mcp-zotero