AI导哈

Zotero集成服务

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

  • by kaliaboi
  • TypeScript
  • 本地部署
  • 164 星标
  • 更新于
在 GitHub 查看 kaliaboi/mcp-zotero

使用说明

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

与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

相关 MCP