docx-mcp 是一个基于 MCP（Model Context Protocol）的服务器，为 AI 编码代理提供创建、读取和编辑 Word（.docx）文档的能力。它的核心特点是直接处理 .docx 内部的 OOXML：.docx 本质上是 XML 文件的 ZIP 归档，该服务器将其解包、直接编辑 XML 再重新打包，因此能够生成真实的修订痕迹（track changes）、线程化批注与脚注，这是许多高层文档库无法实现的。每次编辑在保存前都会依据 OOXML 规范进行校验，可发现孤立脚注、重复内部 ID、损坏的交叉引用等问题，避免 Word 触发“修复”并静默改写文档。
用途与适用人群：适合需要产出 Word 交付物的专业人士，让 AI 代理直接处理文档工作。法律领域可用于合同审查红line、跨模板批量条款替换、为每处修改添加说明批注、脚注管理；安全与渗透测试领域可用于从 markdown 发现生成渗透测试报告、合并多次评估的附录、添加执行摘要评论、交付前移除 DRAFT 水印；咨询领域可用于从模板生成提案与工作说明书（SOW）、将会议记录转为排版交付物、批量更新付款条款；合规与审计领域可用于文档完整性结构校验、交叉引用检查、标题层级审计与保护策略执行。
主要能力：编辑会以修订形式出现在 Word 中——删除显示为红色删除线，插入显示为绿色下划线；修订结束后代理可生成一封邮件即可发送的变更日志，列出每次插入、删除和替换，或直接对比两个文件自动获得相同输出。支持批注与脚注管理、页眉页脚与样式、属性与图片、节与交叉引用、保护与合并、以及验证与审计。可对任意两个文档进行对比，生成 proposal_v1_diff.docx（在 Word 中内联查看修订）和 proposal_v1_diff.txt（纯文本摘要）。可从 markdown 生成报告：标题、受影响主机表格、含概念验证输出的代码块、严重性评级等会转换为匹配客户模板的格式化 Word 文档，并自动应用智能排版（弯引号、破折号、省略号）。
使用方式（示例指令）：审查合同——“打开 contract.docx，找到所有 ‘Net 30’ 改为 ‘Net 60’，并在每处添加批注说明系依据 Amendment 3 更新，另存为 contract_revised.docx。”从 markdown 生成报告——“使用客户报告模板，将 pentest-findings.md 转换为 Word 文档，为每个 CVE 引用添加脚注。”批量编辑模板库——“打开 MSA 模板，将所有 ‘ACME Corp’ 替换为 ‘GlobalTech Inc’，更新页眉中的生效日期，并将文档保护设为仅允许修订。”发送前审计——“打开最终交付物，执行结构审计，检查 DRAFT 或 TODO 标记，验证所有脚注交叉引用，并移除水印。”
安装与配置：Claude Code（推荐）方式下，安装后服务器首次启动会自动安装配套技能，教会 Claude 文档编辑工作流、OOXML 陷阱与审计清单，并随每次升级自动更新；Claude Desktop 需将服务器添加到 MCP 设置；Cursor / Windsurf / VS Code 需添加到各自的 MCP 配置文件。（资料未提供具体安装命令与配置代码内容。）
限制与注意：PII 擦除（scrub_pii）为实验性功能，不适用于生产环境，也不能作为特权、受监管或法律敏感文档的唯一控制手段。它使用 Microsoft Presidio 与 spaCy NER 模型（en_core_web_lg，约 560 MB，首次调用时下载）检测并永久涂黑个人信息，被涂黑区间以纯黑 DrawingML 矩形替换，原文本从 XML 中删除而非仅隐藏。可靠检测（正则/模式匹配，高置信度）包括：电子邮件、电话号码、信用卡号、SSN、IBAN、IP 地址、美国护照号；统计检测（NER，会有遗漏）包括：人名、组织名、地点、日期；已知 NER 缺口包括：全大写姓名（常见于账本、表头、法律当事方称谓）、无上下文环境的单 token 姓名、非英文姓名（阿拉伯语、CJK、非洲姓名模式在该英文模型上召回率低）、嵌入法律样板文本中的姓名（如 Lender: Jane Doe、Authorized Signatory: John Smith）。建议始终将输出视为需要人工复核的第一遍结果。支持 macOS、Linux 和 Windows。
