Zotero Word MCP

MCP文档知识

提供方 Zhangchaokai1

文档知识 未标注 无需鉴权 官方维护

A Windows-based MCP server that enables the insertion of native Zotero citations and bibliographies into Microsoft Word desktop documents. It ensures references remain fully compatible with the official Zotero plugin for dynamic refreshing and ongoing manual maintenance.

一句话选型结论

按资料字段整理

Zotero Word MCP 属于文档知识类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式未标注 鉴权无需鉴权 部署方式本地部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 官方维护 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zotero Word MCP当前 未标注 未标注 本地部署 无 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Zhangchaokai1上游标注的维护方 Zhangchaokai1
分类文档知识本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方官方维护核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.6 KB
来自项目仓库与上游目录的原文,未做删改

zotero-word-mcp

zotero-word-mcp 是一个面向 Windows 的 MCP Server,用于把 Zotero 原生动态引文 直接插入 Microsoft Word 桌面版 文档。

它不是静态编号脚本,也不是通用 .docx 编辑器,而是专门解决下面这个断点:

  • Zotero MCP 负责文献库
  • Word MCP 负责文档内容
  • 但 AI 很难把 Zotero 可继续维护的原生引文 真正插进 Word

本项目补上的就是这一步。

核心能力

  • 向 Word 文档插入 Zotero 原生 ADDIN ZOTERO_ITEM 引文字段
  • 向 Word 文档插入 Zotero 原生 ADDIN ZOTERO_BIBL 参考文献字段
  • 写入 ZOTERO_PREF_1..N 文档首选项
  • 触发 Zotero 官方 Word Refresh
  • 列出文档中的 Zotero 原生字段
  • 设置文档的 CSL 样式
  • 使用 Zotero 官方 libzoteroWinWordIntegration.dll 探测文档是否可被识别
  • 分析并批量转换 [1]、[1, 2]、[1-3] 这类静态数字引用

为什么单独做这个 MCP

普通 Word MCP 更适合:

  • 插段落
  • 排版
  • 查找替换
  • 表格/图片处理

而 zotero-word-mcp 解决的是:

  • 引文必须是 Zotero 原生字段
  • 刷新后要继续被 Zotero 插件接管
  • 用户后续还要能在 Word 里继续点 Add/Edit Citation

这决定了它必须直接面向 Zotero Word 集成,而不是只写普通文本。

适用环境

  • Windows
  • Microsoft Word 桌面版
  • Zotero 7
  • Python 3.10+

当前未完整验证:

  • WPS
  • Word Online
  • 受保护文档
  • 多人实时协作文档

安装```powershell

git clone https://github.com/Zhangchaokai1/zotero-word-mcp.git
cd zotero-word-mcp
pip install -e .


如果你只想本地运行:```powershell
pip install "mcp[cli]" pywin32 requests

配置

可选环境变量:

  • ZOTERO_DATA_DIR
    Zotero 数据目录,例如 D:\Zotero\ZoteroFile
  • ZOTERO_SQLITE_PATH
    指向 zotero.sqlite
  • ZOTERO_WORD_DLL
    指向 libzoteroWinWordIntegration.dll

如果不显式设置,程序会优先从 Zotero prefs.js 自动发现数据目录。

MCP 工具

insert_citation

向 Word 文档插入 Zotero 原生引文。

主要参数:

  • doc
  • keys
  • find_text
  • placement
  • style_id
  • library_id
  • prefix
  • suffix
  • refresh_after
  • wait_seconds

insert_bibliography

向 Word 文档插入 Zotero 原生参考文献字段。

refresh_document

触发 Zotero 官方 Refresh,并等待占位字段解析完成。

list_fields

列出文档中的 Zotero 原生字段和文档首选项。

set_document_style

设置文档 Zotero CSL 样式,不立即刷新。

analyze_numbered_citations

分析 Word 文档中的数字方括号引用和静态参考文献列表,不修改文档。

适合在转换前确认:

  • 正文引用标记数量
  • References 标题段落位置
  • 文末静态参考文献数量
  • 是否有超出参考文献范围的引用编号

主要参数:

  • doc
  • bibliography_heading,默认 References

convert_numbered_citations

将静态数字引用批量替换成 Zotero 原生字段。

支持:

  • [1]
  • [1, 2]
  • [1,2]
  • [1-3]

主要参数:

  • doc
  • citation_map
  • output_doc
  • bibliography_heading
  • library_id
  • style_id
  • locale
  • delete_static_references
  • insert_bibliography
  • refresh_after
  • wait_seconds

citation_map 示例:```json
{
"1": "ABCD1234",
"2": "EFGH5678",
"3": "IJKL9012"
}


推荐智能体使用 `output_doc`,让工具先复制原文档再转换,避免覆盖原文件。

### `validate_zotero_document`

综合验证 Zotero 原生字段状态。

返回:

- citation 字段数量
- bibliography 字段数量
- `{Citation}` / `{Bibliography}` 占位符数量
- bibliography 字段是否从参考文献标题后一段开始
- 当前文档字段列表

### `probe_document`

调用 Zotero 官方 `libzoteroWinWordIntegration.dll` 验证当前文档是否能被官方集成识别。

## 推荐批量转换流程

智能体把静态编号文献转换成 Zotero 原生引用时,推荐使用:

1. 用 `analyze_numbered_citations` 检查编号引用和参考文献列表。
2. 用 Zotero MCP 或其他文献工具生成 `citation_map`。
3. 调用 `convert_numbered_citations`,传入 `output_doc`、`citation_map` 和 `style_id`。
4. 用 `validate_zotero_document` 检查字段数量、占位符和 bibliography 起始位置。
5. 用 `probe_document` 确认 Zotero 官方 Word 集成能识别字段。

## 启动服务```powershell
zotero-word-mcp

如果你的 MCP 客户端支持命令式 server,可以这样配置:toml [mcp_servers.zotero-word] command = "python" args = ["-m", "zotero_word_mcp"]

项目结构

  • src/zotero_word_mcp/word_bridge.py
    Word COM 基础桥接
  • src/zotero_word_mcp/native_bridge.py
    Zotero 原生字段与刷新逻辑
  • src/zotero_word_mcp/server.py
    MCP 工具封装
  • docs/DEVELOPMENT_REVIEW.md
    开发复盘与技术路线说明

与静态引用方案的区别

静态方案通常是:

  • 正文写 [1]
  • 文末写普通文本参考文献
  • 再靠 Word 交叉引用或脚本刷新

这类方案容易控,但不是 Zotero 原生动态引文。

本项目写入的是 Zotero 官方 Word 集成可识别的字段,因此:

  • Zotero 可以继续接管这份文档
  • 用户后续仍能用 Word 里的 Zotero 插件继续维护

已知边界

  • 仅支持 Windows + Word 桌面版
  • 依赖本机可用的 Zotero Word 集成
  • 相邻无间隔插入多个新引文时,Zotero 刷新后可能自动合并为复合引文字段
  • 复杂受保护文档仍建议先做副本测试

开发复盘

详见:

  • docs/DEVELOPMENT_REVIEW.md

License

MIT

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Zotero Word MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Zotero Word MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Zotero Word MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zotero Word MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Zotero Word MCP 能提供哪些能力?

资料显示能力标签包括 文档处理、知识管理、搜索。具体工具清单以官方文档为准。

Zotero Word MCP 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Zotero Word MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。