Safe Docx 是一个本地 MCP 服务器和命令行工具(CLI),主要面向使用编码智能体(coding agent)编辑 Word 和 OpenDocument 文件的场景。它由 docx-primitives、docx-comparison 和 safe-docx MCP 服务器等组件构成。
用途方面,Safe Docx 用于读取、搜索、编辑、比较、转换和保存文档文件。它强调在编辑过程中保留 DOCX 结构,并可以输出干净版本或带修订标记(tracked changes)的版本,便于审阅。典型用法是让编码智能体定位到某个条款(clause),执行针对性编辑,并同时写出两个文件供审阅,而文档其余部分保持在请求编辑范围之外。
主要能力包括:读取、搜索、编辑、比较、转换和保存文档;保留 DOCX 结构;生成干净或带修订标记的输出;支持文档比较。仓库还提供了完整的编辑操作演示(walkthrough)、DOCX 兼容性矩阵、安装与验证说明、TypeScript 库、测试与证据、信任与一致性(Trust and conformance)、标准一致性(Standards Conformance)等内容。此外还提供 Safe Docx Conformance Explorer,用于浏览 ECMA-376 章节、OOXML 模式声明、能力声明、明确的非目标以及跨实现测量结果;生成的仓库一致性报告是受版本控制的记录,包含目标章节、非目标和验证引用。
使用方式上,Safe Docx 作为本地 MCP 服务器和 CLI 运行。需要先安装,然后使用已安装可执行文件的绝对路径配置 MCP 客户端。文档给出了 Claude Code 的配置示例,以及 Antigravity CLI 的配置方式:将 Safe Docx 添加到 ~/.gemini/config/mcp_config.json,重启 agy 后即可要求它编辑 .docx 文件;Antigravity 可能在首次使用前要求批准该 MCP 服务器。安装与验证部分说明了如何定位可执行文件、固定版本以及配置客户端。
适用场景主要是让编码智能体对 Word 文档进行结构化、可审阅的编辑,例如查找并修改特定条款,同时保留格式、修订、批注、脚注等文档要素,并支持文档比较。
限制方面,Safe Docx 不是可视化编辑器或布局引擎,不提供浏览器渲染、实时协作或像素级分页保证。.dotx 模板必须先转换为 .docx 才能使用。仓库还列出了“Safe Docx 未针对哪些场景优化”的说明。
其他信息:仓库包含行为准则(Code of conduct)和安全政策(Security policy)。文档提供英语、西班牙语、简体中文、葡萄牙语、德语版本。