MCP Zotero

用于 Zotero 集成的模型上下文协议服务器，允许 Claude 与您的 Zotero 库进行交互。

设置

1. 获取您的 Zotero 凭证：

   # First, create an API key at https://www.zotero.org/settings/keys
   # Then use it to get your user 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. 验证您的凭证：

   # Test that your credentials work:
   curl -H "Zotero-API-Key: $ZOTERO_API_KEY" \
        "https://api.zotero.org/users/$ZOTERO_USER_ID/collections"

   您应该在回复中看到您的收藏列表。

4. 安装并运行：

   # Install globally (recommended)
   npm install -g mcp-zotero
   mcp-zotero
   
   # Or run directly with npx
   npx mcp-zotero

Related MCP server: Zotero MCP Server

与 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