Zotero MCP Server

Name: Zotero MCP Server
Author: swairshah

本地服务

github.com/swairshah科研与教育2973 周前更新

代码仓库

关于 Zotero MCP Server

Zotero MCP Server 将本地 Zotero 文献库开放给 MCP 客户端，适合需要检索论文并管理笔记的研究者。它支持通过 Zotero API 或直接访问 SQLite 数据库。

主要功能

01按标签搜索论文
02读取论文详情和附注
03为论文添加笔记
04请求论文摘要
05通过 SQLite 直接访问数据

适用场景

01按标签查找研究论文
02查看论文信息及附注
03在论文条目中记录笔记

MCP 相关

该 MCP 服务让 MCP 客户端访问本地 Zotero 文献库，提供论文搜索、详情读取、笔记管理和摘要请求等能力。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Zotero MCP 服务

一个 MCP（Model Context Protocol）服务，可让 MCP 客户端（例如 Anthropic Claude App、Goose，也可能包括 vscode Cline）与本地 Zotero 文献库交互。此服务支持以编程方式访问 Zotero 文库，从而搜索论文、管理笔记等。

注意：如果您不想设置 API 密钥，请参阅下方的 SQLite 数据库服务选项。

设置

安装依赖项：

pip install -e .

在根目录中创建 .env 文件，并填写您的 Zotero 凭据：

ZOTERO_API_KEY=your_api_key_here
ZOTERO_USER_ID=your_user_id_here

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

与 Anthropic Desktop App 集成

若要与 Anthropic Desktop app 集成，请将以下配置添加到 ~/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}
  error: unexpected argument '--directory' found

请使用以下配置，并确保执行 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"
        ]
      }
    }
  }

替代方案：直接访问 SQLite 数据库

如果您更愿意完全绕过 Zotero API，直接使用 SQLite 数据库，请使用 zotero_mcp/db_server.py。此方式让您可以完全掌控 Zotero 数据，不受 API 限制。请注意，使用此方式前需要完全退出 Zotero，因为 Zotero 运行时 SQLite 会锁定数据库。

SQLite 版本的 Claude MCP 配置：

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