FD

flyfish-dev/word-ai

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

10 stars 质量 59 趋势 12AGPL-3.0

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 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.

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, and expected_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.
在 GitHub 查看完整 README

推荐工具

换一个关键词,或者移除筛选条件。

安装

npx skillfish add flyfish-dev/word-ai
新手?先看 mcpskill.org 教程 →