🚰 KitchenSink4Word

微软 Word 的全套工具，应有尽有。 现有最完整的 Word (.docx) MCP 服务器 —— 119 个工具，工程上确保不损坏文档，并针对篇幅长、格式复杂的真实文档进行了压力测试。

起源故事： 某个 AI 代理曾需要 十五分钟 才能编辑 Word 文档中的二十个表格单元格，因为现有的 Word MCP 都无法删除表格列、批量编辑单元格、管理脚注，还要插入目录（TOC）。因此，与其安装三个平庸的服务器，这个项目只用一天就建成了 —— 现在你的代理不会再遇到这个问题。

为什么选这个（诚实的对比）

在构建此项目之前，我们调研了所有公开的 Word MCP 服务器（2026 年 8 月）：

119 个工具，涵盖：文本与格式、表格（包括合并感知的列插入/删除和一次调用的批量单元格编辑）、脚注/尾注（完整增删改查 + 脚注↔尾注转换）、目录与图表目录、页眉/页脚/节、图片、项目符号/编号列表、讨论串评论、修订（读取、按作者接受/拒绝，以及将编辑写成修订），外加基于 Word-COM 的文档比较、域刷新、PDF 导出，以及 Windows 上的无修复提示验证。

Related MCP server: word-mcp-live

v1.2 中的新内容（2026-08-28）

• Word 原生引文与参考文献：结构化源存储、带页码/隐藏开关的 CITATION 域、BIBLIOGRAPHY 域、12 种可选样式（APA、Chicago、MLA、IEEE……）—— 已端到端验证：Word 会以所选样式渲染这些域。

• 索引（支持嵌套和“参见”引用的 XE 条目 + INDEX 域）以及 图表目录（表目录/图目录）。

• 长文档排版工具包：罗马数字页码格式、行号、水印（兼容 Word 的“删除水印”功能）、多栏分节、“第 X 页，共 Y 页”。

• 文档保护：使用与 Word 兼容的 SHA-512 密码哈希（已与 Word 自身输出逐字节比对验证）；trackedChanges 模式会强制收件人的编辑被追踪为修订。

• 结构操作：move_section（一个标题及其整个节，包括表格）、模板迁移（按名称重新映射样式，使格式与参考文档一致）、自定义样式、字符样式、文档属性、图片替代文本。

• 表格功能补全：gridBefore/gridAfter 行、命名表格样式、排序、拆分、重复标题行、嵌套表格读写、单元格文字方向。

• 格式长尾：小型大写字母、隐藏文字、字符间距、字距调整、CJK 语言标记、带前导符的制表位、段落边框/底纹、孤行控制、更改大小写。

• 分析：按节统计字数、APA 引文一致性检查、Word 的校对错误和可读性统计、章节合并、审阅者合并、密码加密保存。

与众不同之处

• 合并感知的表格列操作。 delete_columns / insert_columns 能够正确跨越水平和垂直合并的单元格（gridSpan 缩减，vMerge 链重新锚定）。截至撰写本文时，没有其他公开的 Word MCP 具备此功能。

• 批量优先 API。 编辑 20 个单元格只需一次带数据负载的 set_cells 调用，而不是 20 次往返。

• 修订写入。 在替换/插入/删除/单元格工具上使用 track=True, author="Jane" 会生成真正的 Word 修订，接收者可以接受/拒绝 —— 已通过服务器自身的修订引擎验证往返一致性。

• 文档比较。 com_compare_documents 生成两个文档版本之间的 Word 原生修订标记。

• 绝不损坏文档。 原子保存（临时文件 → 结构验证 → 替换）、每次修改前自动生成带时间戳的备份、对未编辑内容逐字节原样保留（公式、文本框、内容控件完好无损）、以及清晰的类型化错误 —— 当文件在 Word 中打开时会被拒绝并显示提示，而不是挂起。

• 跨碎片 run 安全。 查找/替换可跨越 Word 任意拆分的 run 工作，同时保留逐字符格式；对用户正则表达式设有 ReDoS 超时防护，并提供可选的 max_replacements 影响范围限制。

系统要求

• Windows（COM 工具需要安装 Microsoft Word；所有其他工具都是纯文件操作，无需 Word 即可运行）

• Python 3.12+（在 3.14 上开发）

安装

git clone https://github.com/nometalalchemist/KitchenSink4Word
cd KitchenSink4Word
python -m venv .venv
.venv\Scripts\pip install -e .

在 Claude Code 中注册：

claude mcp add word -s user -- <absolute-path-to>\word-mcp\.venv\Scripts\word-mcp.exe

安全模型

• 每个修改工具都接受 file_path，并在首次修改前在其旁写入一个 <name>.bak-<timestamp>.docx（可用 backup=False 跳过）。

• 保存是原子性的且经过验证；操作失败时原文件保持逐字节不变。

• 删除带有脚注引用的内容会自动移除现已孤立的定义；validate_document / validate_notes 会双向报告完整性。

• 段落删除会拒绝那些会切断域（TOC、PAGEREF）或静默吞掉分节符的范围。

测试

344 个测试，可在任何环境运行：该测试套件针对私有真实文档语料库开发（书级长度的章节、一份包含 171 个脚注的文档、一份包含 126 处修订和审阅者评论的手稿），并且 CI 会自动生成结构等价的合成替身（tests/make_corpus.py），因此完整测试套件可以在任何机器上运行 —— 包括你的机器和每个拉取请求。本地真实文档（如果存在）优先。tests/word_validator.py 在不可见的 Word 中打开输出，并在任何修复提示出现时判定失败 —— 这是决定性的损坏检查。

开发历程：使用 Claude Code 在一天之内构建完成（2026-08-27），经过三轮测试 —— 每个阶段有单元门禁、一次边缘情况会话（89 次调用）、以及两轮通过原始 MCP stdio 传输的“疯狂模式”（规模压力测试、病态合并拓扑、Unicode/模式模糊测试、ReDoS、Word 锁定生命周期、COM 泄漏检查），还有一次专门的跨功能交互缺陷狩猎。所有发现均已用回归测试修复。research/ 记录了实现所依据的 OOXML 算法和陷阱，并注明所研究的 MIT 许可参考实现的出处。

已知限制

• 无法对正在 Word 中打开的文档进行实时编辑（会干净地拒绝；COM 工具可处理已保存的文件）。

• 目录/图表目录的页码需要更新域：下次打开 Word 时自动更新（update_on_open），或通过 com_refresh_fields 立即更新。

许可证

PolyForm Noncommercial 1.0.0 —— 免费供个人、学术、研究及任何其他非商业用途使用。商业使用需要在使用前获得单独许可 —— 请提交 issue 以进行安排。