/ 目录 / 演练场 / Zotero MCP
● 社区 54yyyu 🔑 需要你的密钥

Zotero MCP

作者 54yyyu · 54yyyu/zotero-mcp

与你的 Zotero 文献库对话——搜索上万篇论文、拉取引用、提取笔记摘录,无需离开 Claude。

Zotero MCP 将 Claude 连接到你的 Zotero 文献库(本地或云端)。所有工具都遵循你现有的分类和标签体系。非常适合文献综述合成、引用管理,以及把高亮笔记整理成提纲。

为什么要用

核心特性

实时演示

实际使用效果

zotero-mcp.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "zotero-mcp": {
      "command": "uvx",
      "args": [
        "zotero-mcp"
      ]
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "zotero-mcp": {
      "command": "uvx",
      "args": [
        "zotero-mcp"
      ]
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "zotero-mcp": {
      "command": "uvx",
      "args": [
        "zotero-mcp"
      ]
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "zotero-mcp": {
      "command": "uvx",
      "args": [
        "zotero-mcp"
      ]
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "zotero-mcp",
      "command": "uvx",
      "args": [
        "zotero-mcp"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "zotero-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "zotero-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add zotero-mcp -- uvx zotero-mcp

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: Zotero MCP

综合带标签论文的文献综述

👤 研究生、研究人员 ⏱ ~60 min intermediate

何时使用: 你用 #thesis-ch3 标注了 30 篇论文,需要写第 3.2 节。

前置条件
  • Zotero 已运行(本地 API 已启用) — Zotero 7:设置 → 高级 → 启用本地 API
  • 如使用 Web API,需要 API key — zotero.org/settings/keys
步骤
  1. 拉取文献集
    列出我 Zotero 中所有标注了 thesis-ch3 的条目。只要标题、年份和第一作者。✓ 已复制
    → 整洁的清单,约 30 条
  2. 聚类
    按研究方法对这些条目分组。每条引用用 Zotero key 标注。✓ 已复制
    → 3–5 个聚类,每个聚类附引用列表
  3. 提取 + 写作
    针对「定量 RCT」聚类,提取每条条目中我的高亮,起草一段含行内引用的综述段落。✓ 已复制
    → 段落包含(作者,年份)引用,由真实高亮支撑

结果: 第 3.2 节的初稿,可在此基础上修改,而非从空白开始。

注意事项
  • PDF 没有高亮,只有扫描图 — 先在 Zotero 中运行 OCR(右键 → OCR PDF),再重新提取
搭配使用: filesystem

为正在写的论文生成参考文献

👤 使用 LaTeX 写作的任何人 ⏱ ~15 min beginner

何时使用: 你在草稿中引用了 40 条文献,需要一个统一的 references.bib 文件。

步骤
  1. 扫描引用
    在 /paper/main.tex 中,列出所有 \cite{} 的 key。✓ 已复制
    → 所有引用 key 已枚举
  2. 解析
    对每条引用,从 Zotero 提取 BibTeX 并写入 /paper/references.bib。标注没有匹配项的 key。✓ 已复制
    → bib 文件已写入;未解析的引用已列出

结果: 干净的 references.bib,与你的 Zotero 绑定——无需手动复制粘贴。

注意事项
  • 引用 key 不匹配(Better BibTeX 与默认格式差异) — 在 Zotero 中安装 Better BibTeX 扩展,设置稳定的固定 key 格式
搭配使用: filesystem

组合

与其他 MCP 搭配,撬动十倍杠杆

zotero-mcp + filesystem

将综合结果写入论文草稿

将 Zotero 提取的综述写入 /paper/section-3-2.md。✓ 已复制
zotero-mcp + memory

跨会话记住每篇论文的核心论点

将聚类 A 中每条条目的一句话核心论点存入 memory。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
search_items query: str, tag?: str, collection?: str 在文献库中查找条目 free
get_item key: str 深入检查单条条目 free
get_annotations key: str 提取某篇 PDF 的高亮和笔记 free
get_bibtex keys: str[] 为草稿构建参考文献 free
list_collections none 浏览文献库的分类结构 free

成本与限制

运行它的成本

API 配额
本地 API:无限制。Web API:受 Zotero 速率限制。
每次调用 Token 数
条目元数据约 200 tokens;批注内容可能较多
费用
免费
提示
优先用带标签过滤的 search_items,而非列出所有条目

安全

权限、密钥、影响范围

最小权限: library:read
凭据存储: API key 存储为环境变量(仅 Web 模式)
数据出站: api.zotero.org(Web 模式)或 localhost(本地模式)
切勿授予: library:write unless truly needed

故障排查

常见错误与修复

ECONNREFUSED localhost:23119

Zotero 未运行,或本地 API 未启用。打开 Zotero;设置 → 高级 → 启用本地 API。

验证: `curl http://localhost:23119/api/users/0/items`
Web API 403

API key 缺少文献库读取权限。在 zotero.org/settings/keys 重新生成。

BibTeX keys are auto-generated nonsense

安装 Better BibTeX 插件并设置稳定的引用 key 格式

替代方案

Zotero MCP 对比其他方案

替代方案何时用它替代权衡
Obsidian MCP你的笔记在 Obsidian 而非 Zotero 中数据模型不同——不以论文为核心
Direct Zotero CSL export一次性导出,不需要 LLM 参与无法查询,无法综合

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills