SuperAPI AI 工具集

mcp-zotero

写作与研究

查看项目

更新于 10-16 11:35

技能介绍

MCP Zotero(已弃用)

该技能已弃用。Zotero MCP 集成已被本地 BibTeX 流水线取代,新方案可避免数据库锁定和同步冲突。

迁移指南

变更内容

变更前:Zotero MCP 服务器(mcp-zotero)与 Zotero 的本地 SQLite 数据库进行交互。 变更后:references.bib 作为规范元数据存储;PDF/EPUB 存放在 library/pdfs/,转换后的 Markdown 存放在 library/markdown/。

如何迁移

  1. 将 Zotero 库导出为 BibTeX(文件 → 导出文献库 → BibTeX)。
  2. 运行迁移脚本:

python plugins/sociology-skillset/scripts/migrate-zotero.py
--bib exported.bib
--files ~/Zotero/storage
--output-dir .

该脚本会将 PDF/EPUB 复制到 library/pdfs/,转换为 Markdown,并创建包含 pdf_path 和 md_path 字段的 references.bib。

对于新论文,改用摄入(ingest)脚本而不是 Zotero:

python plugins/sociology-skillset/scripts/ingest.py --file paper.pdf python plugins/sociology-skillset/scripts/ingest.py --file book.epub --doi 10.xxxx/xxxxx

功能替代对照

变更前(Zotero MCP)→ 变更后(本地库)

search_items(query=...) → 在 references.bib 中按作者/标题/年份检索

get_item(item_key=...) → 按引用键在 references.bib 中查找条目

download_attachments(...) → 直接读取 library/pdfs/

Zotero RAG 语义搜索 → uv run plugins/sociology-skillset/scripts/rag.py search "query"

add_item(...) → python ingest.py --file paper.pdf

使用新流水线的技能

所有下游技能(lit-synthesis、reading-agent、bibliography-builder、peer-reviewer、argument-builder)现在从 references.bib 和 library/ 读取,而不再调用 Zotero MCP 工具。

遗留文件

本技能中的 guides/ 和 references/ 子目录仅为参考保留,但不再维护。

适用场景:需要从 Zotero 迁移到本地 BibTeX 文献管理流水线的用户。

限制:该技能已弃用,不应再用于新工作;官方未提供价格、平台等信息。