Zotero MCP 新手完全教程:两步安装,10分钟让 Claude 读懂你的 Zotero 文献库

原创2026-10-14 04:53:453,377 阅读

Zotero MCP 新手完全教程:两步安装,10分钟让 Claude 读懂你的 Zotero 文献库

Zotero MCP 是一个开源的 Zotero 插件,它通过 MCP(Model Context Protocol,模型上下文协议) 把本地的 Zotero 文献库与 Claude、ChatGPT 等 AI 助手连接起来。装上它,你就可以用一句自然语言,让 AI 直接搜索文献、读取 PDF 全文、整理批注和管理元数据,而不用再手动翻找资料库。

本教程面向新手,跟着走 两步安装,10 分钟内让你的 Zotero 文献库变成 AI 可以直接调用的"第二大脑"。

🧩 Zotero MCP 能做什么?

简单来说,Zotero MCP 是一座桥梁:一端是 AI 客户端(Claude Desktop、Cherry Studio、Cursor 等),另一端是你本地的 Zotero 文献管理库。有了这座桥,AI 助手就能帮你完成这些学术高频操作:

  • 🔍 智能检索:按标题、作者、年份、标签、全文多维度搜索,支持布尔运算和相关性评分
  • 📖 全文提取:直接读取 PDF 全文、笔记、摘要和网页快照
  • 📝 批注分析:按颜色、标签、关键词检索 PDF 高亮和注释
  • 📂 分类浏览:浏览 Zotero 分类结构,获取分类下的所有条目
  • 🧠 语义搜索:基于向量嵌入的 AI 概念匹配,跨语言发现相关文献
  • ✏️ 写入操作:创建笔记、管理标签、更新元数据、新建条目

下图是 AI 助手对 Zotero MCP 工具能力的完整说明:

Zotero MCP 插件功能说明,AI 助手列出文献检索、元数据查看、PDF 读取等能力

插件内部已集成了一个 MCP 服务器(核心实现见 streamableMCPServer.ts),采用 Streamable HTTP 协议直接与 AI 客户端通信——无需再单独安装服务器进程,这正是它"两步就能装好"的关键。

📦 安装前准备

开始之前,请确认环境满足以下要求:

项目 要求
Zotero 7.0 或更高版本
操作系统 Windows / macOS / Linux
AI 客户端 Claude Desktop、Cherry Studio、Cursor 等支持 MCP 的客户端

🔒 隐私提示:Zotero MCP 全程在本地运行,你的文献数据不会上传到任何远程服务器,数据隐私完全由你掌控。

🚀 第一步:安装 Zotero MCP 插件

  1. 前往项目的 Releases 页面,下载最新的 zotero-mcp-plugin-x.x.x.xpi 插件文件。
  2. 打开 Zotero,进入菜单 工具 → 附加组件。
  3. 点击右上角齿轮图标 → 安装 .xpi 附加组件…,选择刚下载的 .xpi 文件。
  4. 重启 Zotero,让插件生效。

安装成功后,Zotero 的菜单和首选项里会多出 Zotero MCP Plugin 相关选项,说明插件已就绪。

⚙️ 第二步:配置插件并连接 AI 客户端

重启后,进入 Zotero 的 首选项 → Zotero MCP Plugin 标签页,这里就是整个插件的控制面板(配置界面源码见 preferences.xhtml)。只需做三件事:

1️⃣ 启用服务器 勾选 Enable Server(启用服务器),启动插件内置的 MCP 服务器。

2️⃣ 确认端口 端口默认为 23120,一般保持默认即可;若与其他程序冲突可手动修改。

3️⃣ 生成客户端配置 点击 生成客户端配置 按钮,插件会针对你当前的 AI 客户端自动生成一段连接配置(生成逻辑见 clientConfigGenerator.ts),复制它即可。

最后,把配置粘贴到你的 AI 客户端中。以 Claude Desktop 为例,配置内容类似:

{
  "mcpServers": {
    "zotero": {
      "transport": "streamable_http",
      "url": "http://127.0.0.1:23120/mcp"
    }
  }
}

💡 不同客户端的配置位置略有差异(例如 Claude Desktop 使用 claude_desktop_config.json)。如果你的客户端支持一键导入,直接导入刚才生成的配置最省事。

保存配置并重启 AI 客户端——两步安装,完成! ✅

✅ 10 秒验证连接是否成功

在 AI 客户端里发一句测试指令:

"使用 zotero 工具查找任何一篇文献,返回一条即可"

如果 AI 成功调用了 zotero.search_library 并返回了结果,说明整条链路已经打通。接下来就可以进入实战了。

💡 实战演示:把 Zotero 文献库交给 AI

装好之后,科研写作里最费时间的几类操作都变得很轻松。

1. 用自然语言检索文献

直接说"帮我找一下关于'人工智能'的文献,2024 年以来的",AI 就会调用检索工具(搜索引擎见 searchEngine.ts),把符合条件的文献按标题、作者、年份逐条列出。

Zotero MCP 文献检索示例,AI 按年份筛选人工智能相关文献

2. 一键查看文献元数据

对某篇文献追问"看下这篇的详细信息",AI 会依次调用检索与元数据工具,返回完整的标题、作者、期刊、DOI 和摘要。

Zotero MCP 查看文献元数据,AI 返回标题作者期刊 DOI 和摘要

3. 直接读取 PDF 全文

最实用的场景之一:让 AI 打开某篇论文的 PDF 附件并提取内容。下图展示了一次完整的"查看 PDF 路径"交互:

Zotero MCP 读取 PDF 全文示例一,AI 查询论文 PDF 附件路径

AI 提取出论文第一页的正文后,还能帮你总结核心观点,方便快速判断这篇文献是否值得精读。

Zotero MCP 读取 PDF 全文示例二,AI 提取论文首页内容并总结观点

4. 在命令行客户端里用(Gemini CLI)

Zotero MCP 同样适用于命令行 AI 工具。在 Gemini CLI 中,你可以直接让它检索文献的 PDF 附件位置:

Zotero MCP 命令行客户端检索 PDF 附件位置示例(Gemini CLI)

确认路径后,再让它读取 PDF 并复述全文,一条指令链即可完成"找附件 → 读全文"的完整流程。

Zotero MCP 命令行客户端读取 PDF 全文示例(Gemini CLI)

🐛 常见问题速查

如果配置后工具不工作,按下面这张表逐项排查,能解决绝大多数问题:

现象 可能原因 解决办法
connect ECONNREFUSED 127.0.0.1:23120 Zotero 未运行或服务器未启用 保持 Zotero 打开,并在插件设置中勾选 Enable Server
端口被占用 23120 与其他程序冲突 在插件设置中更换端口,并同步修改客户端配置
Claude 不显示 zotero 工具 配置格式或传输方式错误 确认使用 "transport": "streamable_http" 且 JSON 语法正确,然后重启客户端
服务器启动失败 环境异常 打开 Zotero 的 工具 → 开发者 → 错误控制台 查看报错日志

📖 更完整的工具参数说明(29 个 MCP 工具、5 大分类)可在 README-zh.md 的 API 参考章节查到。

🎯 小结

Zotero MCP 用"两步安装"的方式,把 Zotero 文献库真正变成了 AI 能直接操作的知识库:

  • 第一步:下载 .xpi 并通过 工具 → 附加组件 安装插件,重启 Zotero;
  • 第二步:在 首选项 → Zotero MCP Plugin 里启用服务器、生成客户端配置,粘贴到 AI 客户端。

从文献检索、元数据查看到 PDF 全文读取,AI 助手都能替你搞定。配置完成后,欢迎把你的 Zotero 文献库放心地交给 AI。

登录后查看全文
zotero-mcp