Zotero MCP

zotero-mcp

适用于 Zotero 的读写 MCP 服务。为 AI 助手管理 Zotero 文献库，提供完整的写入支持。

你可以在 Claude Code/Desktop 或任何兼容 MCP 的客户端中创建条目、管理分类、查找并合并重复项，以及导入 BibTeX。

使用 Zotero Web API（需要 API 密钥）。请访问 https://www.zotero.org/settings/keys 获取密钥。

功能

搜索与读取

工具	描述
search_items	全文搜索，支持按分类、类型和标签筛选
get_item	获取单个条目的详细元数据或导出 BibTeX
get_collections	列出所有分类，以及层级结构和条目数量
get_collection_items	列出指定分类中的条目
find_duplicates	按标题/DOI 查找重复项，或扫描整个文献库
get_tags	列出所有标签及其条目数量

写入

工具	描述
create_item	根据字段数据创建条目
create_item_from_doi	根据 DOI 创建条目（通过 Zotero translator + CrossRef 自动填充元数据）
import_bibtex	将 BibTeX 条目导入分类
update_item	更新条目字段，并防止版本冲突

分类

工具	描述
create_collection	创建分类（可选指定上级分类）
add_to_collections	一次性将条目添加到多个分类
remove_from_collection	从分类中移除条目（不会删除条目）

管理

工具	描述
merge_duplicates	合并重复项：将元数据、标签和分类转移至保留项，并删除其余条目
delete_item	删除条目

安装

需要 Python 3.11+ 和 uv。

# Clone the repo
git clone https://github.com/BirdInTheTree/zotero-mcp.git
cd zotero-mcp
uv sync

使用方法

Claude Code

claude mcp add zotero \
  -e ZOTERO_API_KEY=your-key \
  -e ZOTERO_USER_ID=your-user-id \
  -- uv run --directory /path/to/zotero-mcp python -m zotero_mcp

Claude Desktop

添加到 Claude Desktop 配置文件（macOS 上的路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "zotero": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/zotero-mcp", "python", "-m", "zotero_mcp"],
      "env": {
        "ZOTERO_API_KEY": "your-key",
        "ZOTERO_USER_ID": "your-user-id"
      }
    }
  }
}

配置

变量	必需	描述
ZOTERO_API_KEY	是	Zotero Web API 密钥
ZOTERO_USER_ID	是	你的 Zotero 用户 ID

请访问 https://www.zotero.org/settings/keys 获取 API 密钥。你的用户 ID 显示在同一页面上。

示例

连接后，你可以向 AI 助手提出以下请求：

• “在我的 Zotero 中搜索论文……”
• “创建一个名为……的新分类”
• “将这份 BibTeX 导入我的分类”
• “查找文献库中的重复条目并合并”
• “将这篇论文添加到这两个分类中”
• “查询 DOI 10.1234/example 并将其添加到我的文献库”

开发

# Install with dev dependencies
uv sync --dev

# Run tests
uv run pytest tests/ -v

许可证

MIT