AGPL-licensed structure-preserving Word (DOCX) editing MCP server, Codex Skill, and Office.js bridge for AI agents.
概览
Word AI is an open-source MCP server and Office.js bridge for safe, auditable, incremental editing of Microsoft Word documents. It is designed for Codex, OpenAI Agents, and other MCP clients that need to edit .docx files without rebuilding the document or damaging styles, numbering, tables, images, fields, headers, footers, and relationships. AI systems are good at generating text, but Word documents are structured packages. A naive DOCX-to-Markdown-to-DOCX workflow can break numbering, styles, tables, images, fields, references, and layout. Word AI keeps the original DOCX structure as the source of truth: - Agents generate constrained PatchSet operations. - The local engine applies targeted OOXML/Open XML edits. - Every write goes through assessment, dry-run, backup, validation, audit, and diff. - The Office.js add-in provides a Word taskpane for anchor governance and human-in-the-loop workflows.
README
以下为原文 README 节选,完整内容请查看原文。
Word AI
| Language | Preview |
|---|---|
| English | Structure-preserving Word DOCX editing MCP server with a .NET Open XML backend and Office.js live sessions. |
| 中文 | 面向 AI Agent 的 Word DOCX 结构稳定编辑;支持 .NET 后端、Office.js 会话和安全 PatchSet。 |
Structure-preserving Word (DOCX) editing for AI agents.
Word AI is an open-source MCP server and Office.js bridge for safe, auditable, incremental editing of Microsoft Word documents. It is designed for Codex, OpenAI Agents, and other MCP clients that need to edit .docx files without rebuilding the document or damaging styles, numbering, tables, images, fields, headers, footers, and relationships.
Why Word AI
AI systems are good at generating text, but Word documents are structured packages. A naive DOCX-to-Markdown-to-DOCX workflow can break numbering, styles, tables, images, fields, references, and layout. Word AI keeps the original DOCX structure as the source of truth:
- Agents generate constrained
PatchSetoperations. - The local engine applies targeted OOXML/Open XML edits.
- Every write goes through assessment, dry-run, backup, validation, audit, and diff.
- The Office.js add-in provides a Word taskpane for anchor governance and human-in-the-loop workflows.
Key Features
- 63 MCP tools for DOCX inspection, anchors, headings, paragraphs, tables, fields, images, comments, revisions, PatchSet planning, dry-run, apply, validation, rollback, diff, live Word session editing, and optional read-only OfficeCLI evidence.
- PatchSet-only writes. No full document rebuilds, no Markdown/HTML round-trips, and no direct source overwrite by default.
- Agent-friendly PatchSet normalization for common aliases such as
operation,target_tag,new_text,text_sha256, and camelCase operation names, while preserving the canonical safety gates. - Content-control first editing using stable Word content control tags such as
WORD-AI:SRS:1.0:overview. - Strong preconditions with
source_sha256,expected_old_sha256, andexpected_old_text. - Structure validation for package parts, content controls, tables, paragraphs, fields, comments, images, revisions, and protected body blocks.
- Python MCP facade and bridge runtime for local agent integration, path policy, session queues, and distribution compatibility.
- .NET 8 Open XML SDK engine as the authoritative offline DOCX transaction backend, using a packaged native binary or Release DLL when available.
- Single-file standalone binaries and quickstart bundles for no-clone, no-venv, no-.NET-SDK offline DOCX editing and one-command Agent Skill installation.
- Office.js taskpane for Word-side anchors, PatchSet preview, dry-run, apply, and open-document content-control editing with hash checks.
推荐工具
换一个关键词,或者移除筛选条件。
安装
npx skillfish add flyfish-dev/word-ai