docx-mcp

docx-mcp

AI コーディングエージェントが Word 文書を作成、読み取り、編集できるようにします。編集内容は Microsoft Word で変更履歴として表示されます。削除箇所には赤い取り消し線、挿入箇所には緑の下線が付きます。また、修正作業のたびに、エージェントは挿入、削除、置換をすべて記載した、メールで共有できる変更ログを作成できます。2 つの別々のファイルを比較して、同じ形式の結果を自動で取得することもできます。

対象ユーザー

Word 文書を成果物として作成し、AI エージェントに文書作業を直接任せたいプロフェッショナル：

• 法務 — 変更履歴を使った契約書レビュー、テンプレート全体での条項の一括置換、各変更の説明コメントの追加、脚注の管理
• セキュリティとペネトレーションテスト — Markdown の調査結果からペンテストレポートを作成、複数の案件の付録を統合、エグゼクティブサマリーのコメントを追加、納品前に DRAFT の透かしを削除
• コンサルティング — テンプレートから提案書や SOW を作成、会議メモを整った成果物に変換、複数の文書セットで支払い条件を一括更新
• コンプライアンスと監査 — 文書の整合性を構造面から検証、相互参照の確認、見出しレベルの監査、保護設定の適用

エージェントに依頼できること

契約書をレビューする：

「contract.docx を開き、「Net 30」が使われている箇所をすべて見つけて「Net 60」に変更し、それぞれに修正第 3 号に基づいて更新した旨のコメントを追加してください。contract_revised.docx として保存してください。」

Markdown からレポートを作成する：

「pentest-findings.md をクライアントのレポートテンプレートを使って Word 文書に変換してください。CVE への参照ごとに脚注を追加してください。」

テンプレートライブラリを一括編集する：

「MSA テンプレートを開き、「ACME Corp」をすべて「GlobalTech Inc」に置き換え、ヘッダーの発効日を更新して、文書の保護を変更履歴のみの設定にしてください。」

送信前に文書を監査する：

「最終成果物を開き、構造監査を実行し、DRAFT または TODO のマーカーがないか確認してください。脚注の相互参照をすべて検証し、透かしがあれば削除してください。」

エージェントは、ファイルを開き、構造をたどり、完全な修正履歴を残して正確に編集し、整合性を検証して保存するまでのワークフロー全体を処理します。その間、あなたは内容に集中できます。

インストール

Claude Code（推奨）：

claude mcp add docx-mcp -- uvx docx-mcp-server

これで完了です。付属のスキルは、サーバーの初回起動時に自動でインストールされ、文書編集のワークフロー、OOXML の注意点、監査チェックリストを Claude に教えます。アップグレードのたびに自動更新されます。

{
  "mcpServers": {
    "docx-mcp": {
      "command": "uvx",
      "args": ["docx-mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "docx-mcp": {
      "command": "uvx",
      "args": ["docx-mcp-server"]
    }
  }
}

mcpServers:
  docx-mcp:
    command: uvx
    args:
      - docx-mcp-server

pip install docx-mcp-server

例：変更履歴付きの契約書レビュー

1. open_document("services-agreement.docx")
2. get_headings()                              → see document structure
3. search_text("30 days")                      → find the payment clause
4. delete_text(para_id, "30 days")             → tracked deletion  (red strikethrough)
5. insert_text(para_id, "60 days")             → tracked insertion (green underline)
6. add_comment(para_id, "Extended per client request — see Amendment 3")
7. audit_document()                            → verify structural integrity
8. save_document("services-agreement_redlined.docx")

出力を Word で開くと、人間のレビュアーが作成した場合とまったく同じように、変更履歴のマーク、余白のコメント、整ったドキュメント構造を確認できます。

例：改訂作業後の変更ログ

1. open_document("contract.docx")
2. replace_text(para_id, "30 days", "60 days")           → tracked revision (del + ins)
3. add_comment(para_id, "Extended per Amendment 3")
4. save_document("contract_redlined.docx")
5. generate_change_summary("contract_changes.txt")

出力される .txt ファイルは、次のような内容です。

1. REPLACEMENT by Claude on 2026-05-25
   Deleted:  "30 days"
   Inserted: "60 days"

メール、PR の説明、引き継ぎメモなどに貼り付けられます。

例：別々のドキュメントバージョンを比較する

編集セッションは必要ありません。任意の2つのファイルを指定します。

1. diff_to_text("proposal_v1.docx", "proposal_v2.docx")

次の2つのファイルが返されます。

• proposal_v1_diff.docx — Word で開くと、変更履歴が文書内に表示されます
• proposal_v1_diff.txt — そのままどこにでも貼り付けられるプレーンテキストの要約です

例：Markdown からペネトレーションテストレポートを作成

1. create_from_markdown("pentest-report.docx",
       md_path="findings.md",
       template_path="client-template.dotx")
2. audit_document()                            → verify integrity
3. save_document()                             → ready for delivery

Markdown に記載した調査結果（見出し、影響を受けたホストの表、概念実証の出力を含むコードブロック、深刻度の評価）が、クライアントのテンプレートに沿った書式の Word ドキュメントになります。スマートタイポグラフィ（カーリークォート、エムダッシュ、適切な三点リーダー）も自動で適用されます。

PII のスクラブ（実験的機能）

この機能は実験的なものであり、本番環境での使用や、特権情報、規制対象の文書、または法的に機微な文書に対する唯一の管理手段としての使用には適していません。

scrub_pii は、spaCy NER モデル（en_core_web_lg、約 560 MB、初回呼び出し時にダウンロード）と Microsoft Presidio を使用して個人情報を検出し、完全に墨消しします。墨消しされた箇所は黒塗りの DrawingML 長方形に置き換えられます。元のテキストは XML から削除され、単に非表示にされるわけではありません。

安定して検出できるもの（正規表現／パターンマッチングによる高い信頼度での検出）：

• メールアドレス、電話番号、クレジットカード番号、SSN、IBAN、IP アドレス、米国のパスポート番号

統計的に検出するもの（NER による検出のため、見逃しがあります）：

• 人名、組織名、場所、日付

既知の NER の検出漏れ — 次のものは見逃されます：

• すべて大文字で書かれた名前（台帳、表の見出し、法的当事者の表記でよく使われます）
• 前後に文脈のない 1 語だけの名前
• 英語以外の名前（この英語モデルでは、アラビア語、CJK、アフリカ系の名前のパターンは再現率が低くなります）
• 法的な定型文に埋め込まれた名前（Lender: Jane Doe、Authorized Signatory: John Smith）

推奨されるワークフロー：

1. open_document("sensitive.docx")
2. scrub_pii(dry_run=True)             → review detected entities — check for misses
3. scrub_pii("sensitive_redacted.docx") → produce redacted copy
4. open the output in Word and verify manually before sharing

出力は完成した墨消しではなく、人によるレビューが必要な初回処理結果として常に扱ってください。

仕組み

.docx ファイルは、XML ファイルをまとめた ZIP アーカイブです。このサーバーはアーカイブを展開し、XML を直接編集してから再度パッケージ化します。そのため、より高レベルのドキュメントライブラリでは実現できない、実際の変更履歴、コメント、脚注を作成できます。

保存前にすべての編集を OOXML 仕様に照らして検証することで、孤立した脚注、重複した内部 ID、壊れた相互参照など、Word がドキュメントを「修復」する際に暗黙に書き換える原因となる問題を検出します。

要件

• Python 3.10+
• macOS、Linux、Windows で動作します

プライバシーポリシー · 利用規約 · © 2026 Security Ronin Ltd