← 返回目录
A

ai.adeu/adeu

官方
让 LLM 安全生成 Word 修订痕迹。
GitHub 源仓库 ↗
★ 131 Stars 分类 · 文件系统 非常热门
55FMRS · C
可靠性
7/20
安全与权限
9/20
维护活跃度
12/20
文档质量
13/20
安装易用性
14/20

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

查看 FMRS 评分方法 →

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

工具能力

read_docx
读取 DOCX 文档,以适合 LLM 理解的清洁文本或 CriticMarkup 视图返回内容,并支持搜索和分页筛选。
process_document_batch
批量验证并应用文本修改,或按 ID 接受、拒绝和回复现有修订与批注。
finalize_document
清理文档元数据、作者名称和内部跟踪 ID,可锁定文档为只读并准备分发。

安装接入

使用 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"]}}}

选型与风险

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

常见排障

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

使用场景

合同和法律文档的 AI 审阅与修订
将 DOCX 提取为 Markdown 供 RAG 或提示词使用
批量应用可追踪的文本修改
生成两个 DOCX 版本之间的视觉差异
分发前清理文档元数据

支持客户端

Claude Desktop完整支持
Gemini CLI完整支持
Claude Code完整支持
Cursor完整支持
Windsurf完整支持
VS Code Copilot完整支持