zotero-mcp-server

🚀 Zotero MCP 服务器

Zotero MCP 服务器是一个 MCP（模型上下文协议）服务器，它能让 MCP 客户端（如 Anthropic 的 Claude 应用、Goose，甚至 vscode Cline）与本地 Zotero 文献库实现交互。借助这个服务器，你可以通过编程方式访问 Zotero 图书馆，实现搜索论文、管理笔记等功能。

🚀 快速开始

📦 安装指南

1. 安装依赖项：

pip install -e .

2. 在根目录下创建一个 .env 文件，包含你的 Zotero 凭据：

ZOTERO_API_KEY=your_api_key_here
ZOTERO_USER_ID=your_user_id_here

你可以在 Zotero 的设置页面 获取你的 Zotero API 密钥和用户 ID。

💻 使用示例

与 Anthropic Desktop 应用集成

要在 Anthropic Desktop 应用中进行集成，请将以下配置添加到 ~/Library/Application Support/Claude/claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "zotero-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/swairshah/work/research/zotero-mcp",
        "run",
        "python",
        "-m",
        "zotero_mcp.server"
      ]
    }
  }
}

⚠️ 重要提示

如果出现类似以下错误：

{"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"claude-ai","version":"0.1.0"}},"jsonrpc":"2.0","id":0}
  错误: 找到意外参数 '--directory'

请使用以下配置，并确保运行 uv venv; source .venv/bin/activate; uv pip install ".[dev]" 以确保服务器可以与所有依赖项一起运行。

{
   "mcpServers": {
      "zotero-mcp-server": {
        "command": "bash",
        "args": [
          "-c",
          "cd /Users/shahswai/personal/zotero-mcp-server && source .venv/bin/activate && python -m zotero_mcp.server"
        ]
      }
    }
  }

服务器功能示例

该服务器允许你：

• 按标签搜索论文
• 获取论文详细信息和附加笔记
• 添加笔记到论文
• 请求论文摘要