docx-forge

docx-forge-mcp

Word ドキュメント（.docx）の作成と操作に対応する MCP サーバー — AI エージェント向けの本番品質のドキュメント自動化ツールです。

エージェントのワークフローから、契約書、レポート、提案書、コンプライアンス文書を直接生成できます。Word のインストールは不要です。

---

docx-forge-mcp を選ぶ理由

Word ドキュメントは、特に企業や政府機関のワークフローにおいて、契約書、コンプライアンスレポート、法的契約書、ビジネス提案書の標準的な形式です。この MCP サーバーを使うと、Office のインストール、UI の自動操作、ファイル形式に関する推測を必要とせず、AI エージェントがプログラムから .docx ファイルを作成・操作できます。

2026 年時点で、MCP を介して Word ドキュメントを操作できる競合は 1 つだけです。 このサーバーは、本番品質で十分にテストされた実装により、その不足を補います。

---

ツール

ツール	説明
create_document	タイトルと Markdown コンテンツから新しい .docx を作成します
read_document	.docx からテキスト、見出し、段落、メタデータを抽出します
add_section	既存の .docx に新しいセクション（見出し＋本文）を追加します
replace_text	テキストを検索して置換します。テンプレート変数の置換に最適です
add_table	太字のヘッダーを含む書式設定済みの表を .docx に挿入します
merge_documents	複数の .docx ファイルを 1 つに結合します
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-guard-mcp — ループ検出とサーキットブレーカー
• compliance-shield-mcp — EU AI Act の監査証跡