Zotero MCP

Zotero MCP：在 Claude、ChatGPT 等产品中与你的研究资料库对话

让每个 AI Agent 都能访问你的 Zotero 资料库。
通过 Claude、ChatGPT、Codex、Cursor，或 Zotero 内的聊天面板，搜索、阅读、引用和批注论文。

安装 · 文档 · Zotero Agent · Discord

_{Zotero Agent 通过页码引用讲解论文。点击引用即可打开对应页面，并闪烁显示引用的句子。}

Zotero MCP 通过 Model Context Protocol，将你的 Zotero 研究资料库连接到 ChatGPT、Claude 及其他 AI 助手（例如 Cherry Studio、Chorus、Cursor）。你可以搜索资料库、阅读和批注论文、添加和整理条目，并按含义查找研究资料。

**AI Agent：**请先阅读 docs/for-agents.md。其中汇总了应使用的接入方式、设置步骤和相关命令。

三种接入方式

一个软件包 zotero-mcp-server，包含全部三种方式。选择适合你工作场景的方式。

功能

• 搜索：按标题、作者、标签、分类、全文或含义搜索（使用本地、OpenAI、Gemini 或 Ollama 嵌入的语义搜索）
• 阅读：读取 PDF 的元数据、BibTeX、全文和页面范围；当文本提取导致数学公式、图表和表格乱码时，可查看页面图像
• 注释：在精确的文字、图表、表格或公式上添加高亮和区域框；添加笔记；提取 PDF 注释
• 写入：通过 DOI、URL、ISBN、BibTeX 或文件添加论文（含开放获取 PDF），管理分类和标签，合并重复项
• 本地或 Web：本地模式下直接从 zotero.sqlite 读取；写入则发送到正在运行的 Zotero 10+，或通过 Web API 完成
• Scite 引用统计和撤稿提醒（可选）

快速开始

1. 安装（Python 3.10+）：

uv tool install zotero-mcp-server     # or: pip install zotero-mcp-server

不熟悉命令行？ 不妨试试社区打造的 Zotero MCP Setup：macOS 图形界面安装程序、适用于 Mac 和 Windows 的一键脚本，以及分步指南。

2. 启用 Zotero 的本地 API：在 Zotero 7+ 中，打开 Settings → Advanced，勾选 Allow other applications on this computer to communicate with Zotero。

3. 连接你的助手：

zotero-mcp setup      # auto-configures Claude Desktop

{
  "mcpServers": {
    "zotero": {
      "command": "zotero-mcp",
      "env": { "ZOTERO_LOCAL": "true" }
    }
  }
}

zotero-mcp install-skill

zotero-cli plugin     # where the .xpi is, and how to install it

4. 写入（可选）：在 Zotero 10+ 中，运行一次 zotero-mcp authorize-local 并选择 Always Allow。在较旧版本的 Zotero 中，添加 ZOTERO_API_KEY 和 ZOTERO_LIBRARY_ID，以通过 Web API 写入。

然后可以提出诸如 “查找我资料库中关于注意力机制的论文”、“总结这篇论文的关键发现” 或 “高亮这份 PDF 的主要论点” 等请求。

可选扩展

基础安装涵盖搜索、阅读、注释和写入。更多功能可通过扩展添加：

随时运行 zotero-mcp update 更新。

MCP 服务还是 Agent 技能？

如果你的 Agent 可以使用 Shell（Claude Code、Cursor、Codex、Windsurf、Gemini CLI、Amp、OpenCode …），只需一条命令就能教会它使用 zotero-cli：

zotero-mcp install-skill

MCP 服务会在你输入任何内容之前，于每次请求中发送所有工具的架构。Agent 技能只占用 98 个 token，直到 Agent 判断它与当前任务相关：

当你的客户端支持 MCP 但没有 Shell 时（Claude Desktop、ChatGPT），请使用 MCP 服务；当它有 Shell 时，请使用技能。两者共用一份配置。详情：CLI 和 Agent 技能。

Zotero Agent：在 Zotero 中聊天

这个插件会在 Zotero 中添加一个聊天面板，由你自己的 Claude Code、Codex 或 pi 驱动。它能识别你当前打开的条目和页面，并通过 zotero-cli 操作你的文献库。回答会引用论文并附上真实的 zotero:// 链接，点击即可在对应页面打开 PDF。插件已包含在 wheel 中：运行 zotero-cli plugin 获取文件和安装步骤，或者把文档中的一段提示词粘贴给你的 Agent，让它完成设置。详情：Zotero Agent 插件。

网站：stevenyuyy.com/zotero-mcp · 更新日志

贡献

欢迎提交问题和拉取请求。运行 uv run pytest tests/ 执行测试。 docs/integration-test-plan.md 中提供了实时集成测试计划，旨在由 Claude 针对真实文库运行。对于 plugin/ 中插件（AGPL-3.0）的更改，我们接受的条件是维护者也可以根据其他条款（包括商业条款）发布这些更改。

感谢所有为 Zotero MCP 贡献代码、修复和创意的人。

支持

Zotero MCP 免费且开源。

如果它为你或你的实验室节省了时间，赞助将有助于承担那些不那么光鲜的工作：处理 Windows 和 WSL2 的边缘情况、Zotero 架构变更、群组文库支持，以及嵌入和搜索基础设施。

实验室和机构： 50 美元和 200 美元档位旨在方便报销，并包含对影响你工作流的问题的优先分诊。

许可证

MCP 服务和 zotero-cli 使用 MIT 许可证（LICENSE）。plugin/ 中的 Zotero Agent 插件使用 AGPL-3.0-or-later 许可证（plugin/LICENSE），这是 Zotero 本身使用的许可证。