Zoteus:让智能体检索你的 Zotero 文献库并带页码引用
Zotero 文献库的 MCP。智能体能按关键词或语义检索、从 PDF 取带页码的原文段落、按任意 CSL 格式生成引用,还能按 DOI 添加文献。
项目与安装文档
查看项目https://github.com/oscardvs/zoteus
写论文时最怕模型编引用:说得头头是道,页码和原话却对不上。Zoteus 把智能体接到你自己的 Zotero 文献库,回答时引用的是库里 PDF 的原文段落,附带页码,参考文献按真实的条目数据格式化。截至 2026-10-06 只有约 50 star,但 README 和文档的完整度远超同类。
能做什么
- 检索自己的库:标题、摘要、作者、标签的关键词加语义混合检索,也能搜 PDF 和笔记全文,命中段落带页码返回。
- 核对原文:
zotero_get_fulltext返回相关段落及字符位置、最近的标题和页码;zotero_pdf_images把 PDF 某页渲染成图片,图表和公式也能让模型看到。 - 引用和入库:用 citeproc-js 按任意 CSL 样式生成参考文献;给 DOI 或 arXiv ID 就能抓元数据并入库;
zotero_import读入 BibTeX、RIS 等。 - 写回与标注:建条目、改标签、整理分类,
zotero_annotate在 PDF 上加高亮和批注;zotero_scholar经 OpenAlex 查参考文献、被引和撤稿信息。
适合谁
- 文献库有几百上千条、写论文时需要智能体按页码给出原文依据的研究生和学者。
- 做系统综述、需要证据表格和规范参考文献格式的研究团队。
接入方式
需要 Node.js 和正在运行的 Zotero 桌面版(在 Zotero 设置的高级选项里允许其他应用与 Zotero 通信)。Claude Code 里:
claude mcp add --transport stdio zoteus -- npx -y @oscardvs/zoteus
同步、群组库和元数据修改需要再配 ZOTERO_API_KEY。
编辑点评
Zotero 的 MCP 有好几个,这个值得关注是因为它把“可核查”做到了细处:段落带页码和字符位置,证据表里的引文不会和原段落对不上,参考文献走标准的 citeproc-js。读取个人库不需要云端密钥,数据留在本机。要注意它有写权限:能改条目、加批注、移入回收站,永久删除默认关闭,需要 ZOTEUS_ALLOW_DELETE=true 才会执行;只想让它读,就设 ZOTEUS_READ_ONLY=true。全文语义索引默认不开,开了之后大文献库调用嵌入接口的成本不低。项目较新,主要由一位作者维护,另有付费托管版。许可证为 MIT。