Zotero MCP 新手完全教程:两步安装,10分钟让 Claude 读懂你的 Zotero 文献库
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 工具能力的完整说明:
插件内部已集成了一个 MCP 服务器(核心实现见 streamableMCPServer.ts),采用 Streamable HTTP 协议直接与 AI 客户端通信——无需再单独安装服务器进程,这正是它"两步就能装好"的关键。
📦 安装前准备
开始之前,请确认环境满足以下要求:
| 项目 | 要求 |
|---|---|
| Zotero | 7.0 或更高版本 |
| 操作系统 | Windows / macOS / Linux |
| AI 客户端 | Claude Desktop、Cherry Studio、Cursor 等支持 MCP 的客户端 |
🔒 隐私提示:Zotero MCP 全程在本地运行,你的文献数据不会上传到任何远程服务器,数据隐私完全由你掌控。
🚀 第一步:安装 Zotero MCP 插件
- 前往项目的 Releases 页面,下载最新的
zotero-mcp-plugin-x.x.x.xpi插件文件。 - 打开 Zotero,进入菜单
工具→附加组件。 - 点击右上角齿轮图标 →
安装 .xpi 附加组件…,选择刚下载的.xpi文件。 - 重启 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),把符合条件的文献按标题、作者、年份逐条列出。
2. 一键查看文献元数据
对某篇文献追问"看下这篇的详细信息",AI 会依次调用检索与元数据工具,返回完整的标题、作者、期刊、DOI 和摘要。
3. 直接读取 PDF 全文
最实用的场景之一:让 AI 打开某篇论文的 PDF 附件并提取内容。下图展示了一次完整的"查看 PDF 路径"交互:
AI 提取出论文第一页的正文后,还能帮你总结核心观点,方便快速判断这篇文献是否值得精读。
4. 在命令行客户端里用(Gemini CLI)
Zotero MCP 同样适用于命令行 AI 工具。在 Gemini CLI 中,你可以直接让它检索文献的 PDF 附件位置:
确认路径后,再让它读取 PDF 并复述全文,一条指令链即可完成"找附件 → 读全文"的完整流程。
🐛 常见问题速查
如果配置后工具不工作,按下面这张表逐项排查,能解决绝大多数问题:
| 现象 | 可能原因 | 解决办法 |
|---|---|---|
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。






