FORGE — Word / DOCX MCP Server

⚒️ 锻造文字，锁定格式，交付成稿。

Related MCP server: docx-mcp-server

⚒️ 锻造文字，锁定格式，交付成稿。

面向格式的渲染与生成引擎
面向 AI Agent 的模板驱动 Word / DOCX 文档生成与格式约束引擎

面向 AI Agent 的模板驱动 Word / DOCX MCP Server · Word MCP · DOCX MCP · 文档生成
面向 AI Agent 的 Word / DOCX MCP Server，用于模板驱动的 Word 文档生成、格式约束、校验与轻量修复

AI 负责写内容，FORGE 负责守住格式。
AI 负责写内容，FORGE 负责守住格式。

版本 / 当前版本：v1.1

FORGE 是一个本地 stdio MCP 引擎，用于根据结构化内容和可复用模板生成可编辑的 Word DOCX 文件。

FORGE 是一个本地运行的 stdio MCP 文档引擎。它不让 AI 自由“画”Word 格式，而是让 AI 负责理解需求和生成内容，让模板负责定义版式，再由 FORGE 完成目标类型识别、字段约束、模板渲染、OOXML 后处理、校验与轻量修复，最终生成可继续编辑的 .docx 文件。

一句话概括：AI 负责写，模板负责定版，FORGE 负责把内容稳定地放进正确格式。

格式依据

FORGE 的格式体系来自两类来源：

1. 规范性公文版式参考：传统公文模板参考现行推荐性国家标准 GB/T 9704-2012《党政机关公文格式》 的核心排版原则，并结合 Word 模板自动化生成的实际需要进行工程化实现。

2. 业务文档模板经验：论文、周报、活动资料、培训资料等模板来自常见行政、教育与办公场景中的可复用 Word 行文规则，并进一步固化为可由 AI 填充的结构化模板。

说明： GB/T 9704-2012 的参考主要针对“公文类”中的传统公文模板。论文类、周报类、活动类和培训类属于 FORGE 的业务模板规范，不应理解为全部属于国家标准公文格式。FORGE 也不替代最终的人工审校或具体单位内部行文制度。

当前内置格式要求

FORGE 的关键设计原则是：模板才是格式的唯一事实来源（source of truth）。字体、字号、行距、页边距、标题层级、落款位置、表格、图片区域、页码等尽量由模板和固定规则控制，而不是交给大模型临时决定。

支持的目标类型（全版本）

当前版本面向用户提供 5 类正式目标类型。你可以直接用这些名称描述想要生成的材料，FORGE 会将目标类型映射到对应模板和结构规则。

• 论文类：论文 / 演讲稿 / 发言稿 / 长文

• 公文类：传统公文 / 计划 / 总结 / 方案 / 汇报 / 报告 / 请示

• 活动类：传统公文活动方案 / 活动方案 / 活动总结 / 活动影像

• 周报类：行政周报 / 周报

• 培训类：培训通知 / 培训活动记录 / 培训活动影像

目标类型与模板能力

兼容说明： 代码中仍保留 培训通知记录、通知培训资料 等历史兼容入口，用于旧调用方式；新的 AI / MCP 工作流建议优先使用上面的正式目标类型或“成套资料”能力。sample 仅用于验证 MCP 服务与模板渲染，不属于正式业务目标类型。

成套资料

除了单份文档，FORGE 还可以一次生成一组相互配套的材料：

• 活动方案套装：活动方案 → 活动总结 → 活动影像

• 培训资料套装：培训通知 → 培训活动记录 → 培训活动影像

这意味着用户可以直接提出“生成一套活动资料”或“生成一套培训资料”，由 FORGE 按既定顺序生成多个相互对应的 DOCX，而不需要逐份手工调用。

文件范围

当前 FORGE 的核心目标文件是 Microsoft Word .docx：

• 模板：.docx

• AI / MCP 输入：结构化字段（JSON / MCP 参数）

• 输出：可继续编辑的 .docx

• 可在 DOCX 中插入图片、三线表等内容

当前版本不直接生成 PDF、XLSX 或 PPTX。FORGE 的定位不是通用 Office 转换器，而是专注于高稳定性的模板化 Word 文档生成。

这个 MCP 能干什么

把 FORGE 接入 Codex、DeepSeek Harness / DSH 或其他 stdio MCP 客户端后，AI 不只是“帮你写一段文字”，而是可以完成一条完整的 Word 文档工作流：

1. 识别目标类型：先判断需求属于论文类、公文类、活动类、周报类还是培训类，再在该类别中选择具体目标类型，例如“总结”“活动影像”或“培训通知”。

2. 读取模板需要哪些字段：自动获取标题、正文、章节、落款、日期、图片等字段要求和示例数据。

3. 让 AI 先生成结构化内容：把自然语言需求整理为模板可接受的结构化数据，而不是把整篇文字直接硬塞进 Word。

4. 生成 DOCX：按模板渲染内容，并通过 python-docx / OOXML 做必要的后处理。

5. 批量生成成套资料：一次生成活动方案 + 总结 + 影像，或培训通知 + 记录 + 影像。

6. 插入图片和三线表：在支持的模板中将图片、表格内容放到预设版式位置。

7. 校验生成结果：检查 DOCX 的基础内容、布局以及是否遗留未替换的模板占位符。

8. 安全地做轻量修复：处理 NBSP、意外尾随空格等可保守修复的问题，不进行激进的“重排整个文档”。

9. 处理学期辅助规则：提供学年度 / 学期时间辅助信息，帮助涉及学期材料的 AI 生成更合理的日期和周期。

它适合这样的交互：

用户：帮我写一份本学期教研工作总结，按正式公文格式出 Word。

AI
  ↓ 判断类别
公文类
  ↓ 判断目标类型
总结
  ↓ 读取模板字段
get_template_schema
  ↓ 生成结构化内容
标题、开头、一级/二级/三级内容、落款、日期
  ↓
FORGE generate_by_type
  ↓
validate_docx
  ↓
可编辑、格式稳定的 DOCX

生成前后对比

FORGE 的价值不只是“生成一篇文档”，而是把 AI 生成的内容稳定地锻造成格式可控、可继续编辑的 Word 文档。

通用大模型通常很擅长内容生成，但在 Word 文档中，标题层级、段距、落款、页码、表格、图片和模板结构容易出现格式漂移。FORGE 通过模板和固定规则把这些格式责任从大模型手中拿回来。

不使用 FORGE

• 标题层级容易漂移

• 段距与行距不一致

• 落款位置可能偏移

• 表格与图片不易稳定对齐

• 输出结果往往还需要大量人工整理

使用 FORGE

• 标题层级由模板和规则控制

• 正文段距、行距和版式保持一致

• 落款、表格、图片进入预设位置

• 生成结果可直接继续编辑

• 同一模板可以稳定复用到下一份文档

AI 负责写，模板负责定版，FORGE 负责守住格式。
AI 负责写，模板负责定版，FORGE 负责守住格式。

MCP 工具

为什么选择 FORGE

AI 很擅长写内容，但复杂 Word 文档最容易在标题、字体、字号、段距、页边距、页码、表格、图片、落款和层级结构上发生格式漂移。

FORGE 不重新发明 Word，也不鼓励 AI 临时猜格式，而是把模板作为格式的唯一事实来源：

AI content / AI 内容
        ↓
Structured payload / 结构化数据
        ↓
FORGE
        ↓
Template rendering + OOXML post-processing
模板渲染 + OOXML 后处理
        ↓
Validation / 文档校验
        ↓
Editable DOCX / 可编辑 DOCX

客户端支持

• Codex

• DeepSeek Harness / DSH

• 其他支持 stdio MCP 的 AI 客户端

flowchart TD
    A[AI Client] --> B[FORGE stdio MCP]
    B --> C[Document type and schema]
    C --> D[Structured content]
    D --> E[Template rendering]
    E --> F[python-docx / OOXML post-processing]
    F --> G[DOCX validation]
    G --> H[Editable DOCX]

安装

克隆仓库：

git clone https://github.com/IIIIQAQIIII/forge-word-docx-mcp.git
cd forge-word-docx-mcp

macOS / Linux

bash install_mcp.sh

Windows PowerShell

powershell -ExecutionPolicy Bypass -File .\install_mcp.ps1

安装器会创建隔离的虚拟环境、安装依赖项、验证 FORGE 服务器和模板，并为支持的客户端打印或注册 stdio MCP 配置。

安装器会自动创建独立虚拟环境、安装依赖、检查 FORGE MCP Server 与模板，并为支持的客户端自动注册或输出 stdio MCP 配置。

详细安装说明见 INSTALL.md。
详细安装方式见 INSTALL.md。

典型流程

User request / 用户需求
  -> list_document_types
  -> get_template_schema
  -> structured JSON / 结构化内容
  -> generate_by_type
  -> validate_docx
  -> DOCX

仅提供文件名时，生成文件默认保存到 outputs/。
仅指定文件名时，生成结果默认保存到 outputs/。

公开版本与脱敏策略

本仓库是基于独立的私有开发源生成的脱敏公开快照。公开构建不继承私有 Git 历史。

本仓库是由独立 Private 开发源生成的脱敏公开快照，公开仓库不会继承 Private 仓库的 Git 历史。

在生成公开快照之前，构建会检查文本文件和 DOCX 包 XML 中的禁用词和高风险个人信息模式；同时清除文档作者元数据、移除 Word 预览缩略图、将私有的内嵌模板图片替换为空白占位符，并拒绝批注、修订、嵌入对象或外部关系。

公开构建会扫描文本和 DOCX 内部 XML 中的敏感词与高风险个人信息模式，并清除作者元数据、Word 预览缩略图和私有模板图片；同时拒绝批注、修订记录、嵌入对象和外部关系等可能造成信息泄露的结构。

本公开版本中的单位名称、人员名称和示例内容均为虚构或脱敏信息，不代表任何真实机构或个人。

Private 与 Public 发布版可以使用相同版本号，但提交 SHA 不同。

Private 与 Public 可以使用相同版本号，但 Git Commit SHA 独立。

开源许可

FORGE 采用 MIT License 发布，完整许可文本见 LICENSE。

FORGE 使用 MIT License 开源，完整许可文本见 LICENSE。