MCP Zotero

这是一个用于 Zotero 集成的 Model Context Protocol 服务器，允许 Claude 与你的 Zotero 图书馆进行交互。

<a href="https://glama.ai/mcp/servers/mjvu0xzzzz"><img width="380" height="200" src="https://gips2.baidu.com/it/u=3177697769,566165823&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Zotero MCP 服务器" /></a>

设置

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