docx-forge

docx-forge-mcp

用于创建和操作 Word 文档（.docx）的 MCP 服务——面向 AI Agent 的生产级文档自动化工具。

直接通过 Agent 工作流生成合同、报告、提案和合规文档。无需安装 Word。

---

为什么选择 docx-forge-mcp？

Word 文档是合同、合规报告、法律协议和商业提案的默认格式，尤其是在企业和政府工作流中。此 MCP 服务让 AI Agent 能以编程方式创建和操作 .docx 文件，无需安装 Office、使用 UI 自动化，也无需猜测文件格式。

截至 2026 年，只有 1 个竞品能通过 MCP 操作 Word 文档。此服务以生产级、经过全面测试的实现填补了这一空缺。

---

工具

工具	描述
create_document	根据标题和 Markdown 内容创建新的 .docx
read_document	从 .docx 中提取文本、标题、段落和元数据
add_section	在现有 .docx 中追加新章节（标题 + 正文）
replace_text	查找并替换文本，非常适合替换模板变量
add_table	在 .docx 中插入带粗体表头的格式化表格
merge_documents	将多个 .docx 文件合并为一个
export_to_pdf	通过 LibreOffice 或 pandoc 将 .docx 转换为 PDF
get_document_stats	获取字数、页数估算、章节数和表格数

---

安装

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "docx-forge": {
      "command": "npx",
      "args": ["docx-forge-mcp"]
    }
  }
}

Cursor

添加到你的 .cursor/mcp.json：

{
  "mcpServers": {
    "docx-forge": {
      "command": "npx",
      "args": ["docx-forge-mcp"]
    }
  }
}

手动安装（Node.js）

npm install -g docx-forge-mcp
docx-forge-mcp

---

使用示例

根据模板创建合同

create_document(
  title="Service Agreement",
  content="# Parties\n\n**Client:** {{CLIENT_NAME}}\n**Provider:** Acme Corp\n\n## Scope of Work\n\n{{SCOPE}}\n\n## Payment\n\n{{PAYMENT_TERMS}}",
  outputPath="/tmp/contract.docx"
)

replace_text(filePath="/tmp/contract.docx", find="{{CLIENT_NAME}}", replace="TechCorp Ltd")
replace_text(filePath="/tmp/contract.docx", find="{{SCOPE}}", replace="Software development and consulting services.")
replace_text(filePath="/tmp/contract.docx", find="{{PAYMENT_TERMS}}", replace="Net 30 days. $15,000/month.")

export_to_pdf(filePath="/tmp/contract.docx", outputPath="/tmp/contract.pdf")

编写结构化报告

create_document(
  title="Q1 2026 Performance Report",
  content="## Executive Summary\n\nRevenue grew 34% YoY.",
  outputPath="/tmp/report.docx"
)

add_section(
  filePath="/tmp/report.docx",
  heading="Revenue Breakdown",
  content="Product A: $450K\nProduct B: $320K\nServices: $180K",
  headingLevel=2
)

add_table(
  filePath="/tmp/report.docx",
  headers=["Product", "Q1 Revenue", "Growth"],
  rows=[["Product A", "$450K", "+41%"], ["Product B", "$320K", "+28%"], ["Services", "$180K", "+19%"]]
)

get_document_stats(filePath="/tmp/report.docx")

读取并检查现有文档

read_document(filePath="/path/to/existing.docx")
# Returns: { text, paragraphs[], headings[], metadata: { wordCount, fileSizeBytes, ... } }

将章节文件合并成一本书

merge_documents(
  filePaths=["/docs/ch1.docx", "/docs/ch2.docx", "/docs/ch3.docx"],
  outputPath="/docs/complete-manual.docx"
)

---

Markdown 支持

create_document 和 add_section 都接受 Markdown 内容：

Markdown	结果
# Heading 1	H1 标题
## Heading 2	H2 标题
**bold text**	粗体文本
*italic text*	斜体文本
- item	项目符号列表项
1. item	编号列表项
---	水平分隔线
空行	段落分隔

---

导出 PDF

export_to_pdf 需要系统级转换器。它会按以下顺序尝试：

1. LibreOffice（保真度最高）— sudo apt-get install libreoffice
2. pandoc — sudo apt-get install pandoc

如果两者都不可用，该工具会返回 success: false，并提供安装说明。源 .docx 文件始终会保留。

---

资源

URI	描述
docx-forge://usage-guide	包含工作流示例的分步指南

---

依赖项

• docx — 创建 .docx（无需 Office）
• mammoth — 读取 .docx 并提取文本
• @modelcontextprotocol/sdk — MCP 协议
• zod — 输入验证

---

要求

• Node.js >= 18.0.0
• 无需安装 Microsoft Word 或 Office
• 导出 PDF 需要 LibreOffice 或 pandoc（可选）

---

开发

git clone https://github.com/mdfifty50-boop/docx-forge-mcp
cd docx-forge-mcp
npm install
npm test        # Run test suite
npm start       # Start MCP server (stdio)

---

许可证

MIT — 参见 LICENSE

---

相关 MCP 服务

• agentic-observability-mcp — 跟踪、追踪成本并监控 Agent 操作
• agent-guard-mcp — 循环检测和熔断器
• compliance-shield-mcp — EU AI Act 审计跟踪