Adeu

官方

让 LLM 安全生成 Word 修订痕迹。

分类: 文件系统第 14 / 24
Stars: ★ 168 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js · Python
凭据: 无需凭据
许可证: MIT
最近提交: 11 天前
工具数: 3

55FMRS · C

资料显示 Adeu 是由 Adeu 团队维护的官方 DOCX 修订 MCP 服务器，提供 stdio 传输、Node.js npm 包和 Python 后端。其核心价值是把经过验证的 LLM 文本编辑转换为 Word 原生修订，同时保留文档结构；使用者仍需承担文件权限、LLM 数据处理和人工审阅责任。

最强项 · 安装易用性 14/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

9/20

维护活跃度

12/20

文档质量

13/20

安装易用性

14/20

查看各项评分依据

可靠性 7/20: 清单仅声明一个通过 stdio 运行的 npm 包，未列出工具定义；README 描述了 read_docx、process_document_batch 和 finalize_document 等工具，但在给定材料中无法核对其实际实现、初始化握手、工具列表或错误处理。README 提供了多种调用路径，但没有提交的测试内容或 CI 工作流证据，因此只能认为正常路径可行，可靠性因不可验证性和边界情况证据不足而扣分。
安全与权限 9/20: README 声称核心引擎和本地文件工具默认在本机离线执行，且不会上传本地文档；同时公开说明了所选 LLM 提供商会处理代理读取的文本。材料未显示凭据处理、权限范围、路径隔离、危险操作确认、网络访问控制或审计机制；工具还可以修改 DOCX、处理评论/修订并锁定文档。未发现提示中的红线风险，但由于数据边界和副作用控制不充分，安全性扣分。
维护活跃度 12/20: 仓库未归档，有明确项目团队、MIT 许可证、1.30.0 版本和 CI 徽章，且 README 提供了 Python、Node.js 及多个集成入口，说明存在持续维护迹象。材料没有提交历史、发布日期、依赖更新策略、漏洞响应渠道或可核查的 CI 流程内容；开放 issue 数为 0 只能作为有限信号，不能证明长期响应能力，因此未给满分。
文档质量 13/20: README 覆盖了项目定位、安装方式、多个 MCP 客户端配置、工具工作流、Python/TypeScript SDK、CLI、平台差异和数据处理声明，并给出示例。工具参数、失败场景、兼容性限制、认证、成本、故障排查以及链接文档的具体内容仍不完整，且部分能力仅由 README 宣称，缺少源代码证据，因此扣分。
安装易用性 14/20: 提供 npx、uvx、Claude Desktop 扩展、Gemini CLI、Smithery 以及通用 MCP JSON 配置，且给出 Node.js 与 Windows Live Word 的 Python 路径，主流客户端的安装步骤较清晰。仍需预装 Node.js/uvx 或特定客户端，Windows Live Word 有额外平台依赖，且给定材料没有可验证的端到端连接测试；按静态审查上限保守扣分。

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

查看 FMRS 评分方法 →

选型与风险

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

适合谁

需要保留 Word 修订痕迹和既有格式的法律科技团队
处理本地 DOCX 文件的 AI 代理工作流
希望通过 Python 或 TypeScript SDK 集成文档处理的开发者

不适合谁

只需要从零生成简单 DOCX 的场景
不需要 Word 修订或复杂 XML 保留的纯文本编辑
需要云端邮件抓取等 Adeu Cloud 扩展功能但未连接 Adeu Cloud 的场景

所需权限

需要读取用户指定的 DOCX 文件
应用修改时需要写入输出文档或原文目标位置
实时 Microsoft Word 集成需要 Windows、Microsoft Word 和 Python 后端
文档文本会被代理使用的 LLM 提供商处理

风险与副作用

错误或过于宽泛的匹配可能导致不期望的修订，因此引擎会阻止歧义匹配和无效结构修改
AI 生成的修改仍可能不符合业务或法律意图，需要人工审阅
文档内容会交给所选 LLM 提供商处理，敏感文件应依据组织政策使用
最终清理或只读锁定会改变文档元数据和编辑状态，操作前应确认目标文件

安装接入

准备工作

运行环境：Node.js · Python

使用 Node.js MCP 后端：在支持 MCP 的客户端中加入给定配置，并运行 npx -y @adeu/mcp-server。也可使用 Python 后端：运行 uvx --from adeu adeu-server；Windows 上进行实时 Microsoft Word 集成时需要 Python 后端。Gemini CLI 可运行 gemini extensions install https://github.com/dealfluence/adeu；Claude Desktop 也可安装 GitHub Releases 提供的 Adeu.mcpb 扩展。

claude_desktop_config.json

{"mcpServers":{"adeu":{"command":"npx","args":["-y","@adeu/mcp-server"]}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "adeu": {
      "command": "npx",
      "args": [
        "-y",
        "@adeu/mcp-server"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add adeu -- npx -y @adeu/mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

连接后在客户端工具列表中确认出现 read_docx、process_document_batch 和 finalize_document，然后让 agent 读取一个 .docx 文件验证 Markdown 投影是否正常。

常见排障

确认 MCP 客户端使用 stdio 配置，并检查 npx 或 uvx 可用
Node.js 后端使用 @adeu/mcp-server；Windows 实时 Word 集成改用 Python 后端 adeu-server
若修改未应用，检查目标文本是否唯一且结构变更有效；歧义匹配会被安全门阻止
确认客户端已安装对应扩展或插件，并使用正确的 DOCX 文件路径
需要分发文件时检查 finalize_document 的元数据清理和保护模式设置

试试这样问

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

读取 contract.docx 并找出所有定义条款。
把文档里所有'State of New York'改成'State of Delaware'，并加批注说明。
拒绝第3条现有的修订建议，并回复作者保留原条款的理由。
在发送给客户之前，清除文档中的作者元数据并设置只读保护。

工具能力 3

read_docx 只读

读取 DOCX 文档，以适合 LLM 理解的清洁文本或 CriticMarkup 视图返回内容，并支持搜索和分页筛选。

process_document_batch 写入

批量验证并应用文本修改，或按 ID 接受、拒绝和回复现有修订与批注。

finalize_document 破坏性

清理文档元数据、作者名称和内部跟踪 ID，可锁定文档为只读并准备分发。

使用场景

合同和法律文档的 AI 审阅与修订

将 DOCX 提取为 Markdown 供 RAG 或提示词使用

批量应用可追踪的文本修改

生成两个 DOCX 版本之间的视觉差异

分发前清理文档元数据

支持客户端

Claude Desktop

Gemini CLI

Claude Code

Cursor

Windsurf

VS Code

依据项目文档列出，未经本站实测。

详细介绍

Adeu 是一个将 DOCX 与 LLM 之间进行双向转换的 MCP 服务器。它把 Word 文档投影为适合 LLM 编辑的 Markdown 和 CriticMarkup，再将经过验证的文本修改转换为原生 Word 修订，同时尽量保留格式、布局、复杂 XML 和批注。项目提供 Python 与 Node.js 实现，并采用 MIT 许可证。