mcp-zotero

mcp-zotero 是一个面向 Zotero 集成的 Model Context Protocol（MCP）服务器，允许 Claude 与用户的 Zotero 图书馆进行交互。它主要解决在 Claude 中直接访问和管理 Zotero Cloud 上收藏与文献来源的需求。

主要能力

该服务器提供以下可用工具：

• get_collections：列出图书馆中的所有集合。
• get_collection_items：获取特定集合中的条目。
• get_item_details：获取某篇论文的详细信息。
• search_library：搜索整个图书馆。
• get_recent：获取最近添加的论文。

使用方式

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
   

5. 与 Claude Desktop 集成： 在 Claude Desktop 配置中添加相应配置即可使用。

适用场景

适用于需要在 Claude 中查阅、检索或管理 Zotero 图书馆文献的研究人员、学生或写作者，可快速获取集合结构、论文详情和最近添加内容。

限制

该工具依赖 Zotero API 密钥和用户 ID，需要有效的 Zotero 账户和网络连接。其功能范围限于资料中说明的五个工具，其他能力暂未提供。