Safe Docx MCP Server

社区

以AI原生方式精准编辑 Word 与 OpenDocument 文档，保留原有格式

分类: 文件系统第 3 / 24
Stars: ★ 46 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 14 天前

68FMRS · C

Safe Docx 是一个面向编码代理的本地文档编辑 MCP 服务器（stdio，npm 分发，Apache-2.0），主打对 .docx/.odt 的外科手术式编辑与格式保留，提供符合性报告佐证其 OOXML 兼容性；但不适合作为可视化编辑器或协作工具使用。

最强项 · 文档质量 18/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

16/20

维护活跃度

14/20

文档质量

18/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 项目有CI流程和codecov覆盖率报告，表明有基本的测试覆盖。服务器manifest提供了版本信息和架构描述，但无法验证实际工具实现和错误处理。静态分析无法确认完整的功能实现，因此评分保守。
安全与权限 16/20: 项目使用Apache 2.0许可证，有明确的权限边界。没有发现凭证处理问题或危险操作默认值。文档中明确说明是本地处理，不涉及外部网络，数据边界清晰。没有发现明显的安全风险。
维护活跃度 14/20: 项目有定期的CI构建和版本发布，GitHub上有活跃的问题跟踪。依赖关系有明确的管理方式，许可证为Apache 2.0，有安全响应渠道。虽然问题数量较多(52个)，但大多数可能已关闭或处于活跃状态。
文档质量 18/20: 提供了详细的安装指南、工具参考和架构说明。有多语言支持，包括中文。文档中包含了限制和兼容性说明，有完整的教程和比较指南。文档结构清晰，覆盖了使用场景和限制条件。
安装易用性 12/20: 安装步骤明确，通过npm全局安装，并提供MCP客户端配置示例。但需要用户手动找到可执行文件的绝对路径，这可能对某些用户造成困扰。没有提供自动化安装脚本，需要用户手动配置。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件

适合谁

需要通过编码代理对 .docx/.odt 文件进行精准、保留格式的局部编辑的开发者
需要生成带修订记录以供人工审阅的文档修改流程

不适合谁

需要浏览器渲染、实时协作或像素级分页保证的可视化编辑场景
直接使用 .dotx 模板（需先转换为 .docx）

所需权限

读写本地文档文件（.docx / .odt）的文件系统访问权限

风险与副作用

文档编辑作用于本地文件，错误的针对性修改可能覆盖原文内容，建议利用其干净版/修订版双输出进行审阅
项目声明并非可视化编辑器或排版引擎，复杂版式结果需人工核对

安装接入

准备工作

运行环境：Node.js

运行 npm install --global @usejunior/safe-docx 全局安装，然后在 MCP 客户端中配置可执行文件的绝对路径。例如在 Claude Code 中执行：claude mcp add safe-docx -- /absolute/path/to/safe-docx。

验证是否装好

全局安装后，将可执行文件的绝对路径配置到 MCP 客户端（如 claude mcp add safe-docx -- /absolute/path/to/safe-docx），然后让客户端读取一个 .docx 文件；若能返回文档内容，说明连接正常。

常见排障

确认 npm 包已全局安装并使用可执行文件的绝对路径配置客户端
检查 .dotx 模板是否已先转换为 .docx
查阅仓库的 docs/installation.md 了解版本固定与客户端配置方法

试试这样问

连接成功后，可以直接对 AI 助手这样说：

编辑 NDA.docx，把管辖法律从纽约改为特拉华，保存一份干净副本和一份修订追踪副本，其他内容不要改动。
在这个 .docx 文件里搜索所有提到 'confidentiality' 的段落并告诉我位置。
把 report.docx 转换并另存为一份保留格式的新文件。
比较 contract-v1.docx 和 contract-v2.docx，列出两者的差异。

使用场景

让编码代理对合同等 .docx 文件做局部修改（如更改管辖法律条款），同时输出干净版和修订版

搜索、比较和转换 Word / OpenDocument 文档

详细介绍

Safe Docx 是一个本地 MCP 服务器和 CLI，用于读取、搜索、编辑、比较、转换和保存 .docx 与 .odt 文档。它通过 npm 包 @usejunior/safe-docx 以 stdio 方式运行，可在保留文档结构的同时生成干净版本或带修订记录（tracked changes）的版本。项目采用 Apache-2.0 许可证，并提供了针对 ECMA-376 / OOXML 的符合性报告。源材料未列出具体工具名称，故工具清单留空。