zotero-manager-mcp

English | 简体中文

zotero-manager-mcp — Zotero 条目管理 MCP 插件，适配 Zotero 10。

提供 Zotero 条目的元数据管理、注释与分类能力。

功能

Related MCP server: zotero-local-mcp-bridge

安装

1. 下载最新的 xpi 文件（见 Releases 或 GitHub Pages）。

2. Zotero → 工具 → 插件 → ⚙️ → Install Plugin From File…

3. 选择下载的 .xpi，重启 Zotero。

升级时先移除旧版本再安装。

安装完成后，插件 update_url 指向 GitHub Pages 上的 update.json，Zotero 会在版本号升高时自动检测并安装新版本。

连接 MCP 客户端

插件启动后在 127.0.0.1:23121 提供 Streamable HTTP 的 /mcp 端点（只监听本机）。

在 Zotero 插件设置的 「MCP 连接信息」 面板可查看端点并一键复制。

http://127.0.0.1:23121/mcp

通用 JSON 形态（字段名因客户端而异，请按对应文档适配）：

{
  "type": "http",
  "url": "http://127.0.0.1:23121/mcp"
}

工具参考

检索

search_library — 高级检索，支持布尔运算与相关性排序。 常用参数：q、title、yearRange、fulltext（Zotero 原生全文）、fulltextMode（attachment/note/both）、fulltextOperator（contains/exact/regex）、itemType、tags、limit、offset。

search_libraries / get_libraries — 检索 / 列出库。

条目

get_item_details — 条目完整元数据（题录信息、创建者、标签、附件等）。

get_item_abstract — 条目摘要（abstractNote）。

get_content — 条目正文，聚合 Notes、Markdown/文本附件、摘要、网页快照。

注释

search_annotations / get_annotations — 检索 / 读取批注与高亮。

分类

get_collections / search_collections、get_collection_details、get_collection_items、get_subcollections。

分类写：create_collection / update_collection / delete_collection / add_items_to_collection / remove_items_from_collection。

写操作（默认关闭）

write_note、write_tag、write_metadata、write_item 默认禁用（安全考虑）。在插件设置里打开 「启用写入操作」。

内容模式与默认参数

默认 standard 模式，单次读取量受模式限制：

工具调用时可传 mode 参数覆盖。

开发

npm install
npm run build     # 构建到 .scaffold/build/zotero-manager-mcp.xpi
npm run start     # 开发模式（热重载）

技术栈：TypeScript + zotero-plugin-scaffold。

打 tag vX.Y.Z 触发 GitHub Actions，自动构建 xpi 并部署 update.json + xpi 到 GitHub Pages（自动更新通道）。

License

MIT。