Word MCP Live

word-mcp-live を使うと、MCP に対応した AI アシスタントから Microsoft Word を自在に操作できます。文書を開き、必要な作業を AI に伝えれば、書式設定、変更履歴、コメントなどが実行される様子を確認できます。変更は開いている文書にリアルタイムで反映されます。

実際の動作を見る

https://github.com/user-attachments/assets/fbb09af4-1e25-4e49-94d0-45b363278810

他との違い

• ライブ編集 — Word で文書を開いたまま編集できます。保存して閉じ、再度開く必要はありません。
• 完全な取り消し — AI の各操作は Ctrl+Z 1 回で取り消せます。間違えても、すぐに元に戻せます。
• ネイティブな変更履歴 — XML を使った小細工ではなく、あなたの名前が記録される Word の本物の変更履歴です。
• スレッド形式のコメント — 人間のレビュアーのように、コメントの追加、返信、解決、削除ができます。
• レイアウト診断 — 書式の問題を検出し、印刷時の大きなトラブルを未然に防ぎます。
• 数式と相互参照 — 数式や自動更新される参照を挿入できます。
• 124 個のツール — 利用できる Word MCP サーバーの中で、最も包括的なツールセットを備えています。

クイックスタート

pip install word-mcp-live

または、ソースからインストールします。

git clone https://github.com/ykarapazar/word-mcp-live.git
cd word-mcp-live
pip install -e .

クライアントへのインストール

{
  "mcpServers": {
    "word": {
      "command": "uvx",
      "args": ["word-mcp-live"],
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

{
  "mcpServers": {
    "word": {
      "command": "uvx",
      "args": ["word-mcp-live"],
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

{
  "mcpServers": {
    "word": {
      "command": "uvx",
      "args": ["word-mcp-live"],
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "word": {
        "command": "uvx",
        "args": ["word-mcp-live"],
        "env": {
          "MCP_AUTHOR": "Your Name",
          "MCP_AUTHOR_INITIALS": "YN"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "word": {
      "command": "uvx",
      "args": ["word-mcp-live"],
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

{
  "mcpServers": {
    "word": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/ykarapazar/word-mcp-live"],
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

MCP_AUTHOR は、変更履歴とコメントに記録する名前を設定します（デフォルト："Author"）。MCP_AUTHOR_INITIALS は、コメントに表示するイニシャルを設定します。

2つのモード

どちらのモードも連携して動作します。AI がタスクに応じて適切なモードを選択します。

macOS ライブ編集（v1.5.0 の新機能）

ライブツールが JavaScript for Automation（JXA）経由で macOS でも動作するようになりました。同じツール名、同じパラメーターを使用します。サーバーがプラットフォームを検出し、適切な自動化バックエンドを使用します。

設定

リモートデプロイについては、RENDER_DEPLOYMENT.md を参照してください。

プロンプトの例

AI に、希望する内容を普段の言葉で伝えるだけです：

"Draft a contract with tracked changes so my colleague can review"
"Format all headings as Cambria 13pt bold and add automatic numbering"
"Add a comment on paragraph 3 asking about the deadline"
"Find every mention of 'ABC Corp' and replace with 'XYZ Ltd' as a tracked change"
"Set the page to A4 landscape with 2cm margins"
"Insert a table of contents based on the document headings"
"Add page numbers in the footer and our company name in the header"
"Insert a cross-reference to Heading 2 in paragraph 5"

使用例

例 1：ドキュメントを読み取る（クロスプラットフォーム）

ツール呼び出し： get_document_text

{ "filename": "C:/Documents/report.docx" }

期待される出力：

{
  "status": "success",
  "paragraphs": [
    {"index": 0, "text": "Quarterly Report", "style": "Heading 1"},
    {"index": 1, "text": "Revenue increased by 15% compared to Q3.", "style": "Normal"},
    {"index": 2, "text": "Key Metrics", "style": "Heading 2"}
  ],
  "total_paragraphs": 3
}

例 2：変更履歴を記録しながらライブ編集する（Windows）

ツール呼び出し： word_live_replace_text

{
  "filename": "report.docx",
  "find_text": "ABC Corporation",
  "replace_text": "XYZ Ltd",
  "match_case": true,
  "replace_all": true,
  "track_changes": true
}

期待される出力：

{
  "status": "success",
  "replacements": 4,
  "message": "Replaced 4 occurrences (tracked changes enabled)"
}

置換内容は Word の変更履歴として表示され、「ABC Corporation」には取り消し線が、「XYZ Ltd」には下線が付きます。

例 3：テキストに紐付けたコメントを追加する（クロスプラットフォーム）

ツール呼び出し： add_comment

{
  "filename": "C:/Documents/contract.docx",
  "target_text": "payment within 30 days",
  "comment_text": "Should we extend this to 45 days?",
  "author": "Jane Smith"
}

期待される出力：

{
  "status": "success",
  "message": "Comment added by Jane Smith on 'payment within 30 days'"
}

コメントは Word の［校閲］パネルに表示され、指定したテキストに紐付けられます。

ツールリファレンス

2つのモードにわたる 124 個のツール については、詳細が記載されたツールリファレンス全文を参照してください。

要件

• Python 3.11+
• python-docx、fastmcp、msoffcrypto-tool（自動的にインストールされます）
• Windows ライブツール： Windows 10/11 + Microsoft Word + pywin32（自動的にインストールされます）
• macOS ライブツール： macOS + Microsoft Word for Mac（組み込みの JXA を使用するため、追加の依存関係はありません）

クロスプラットフォームツールは Word がインストールされていなくても動作します。必要なのは python-docx のみです。

コントリビューション

開発環境のセットアップ、コードスタイル、新しいツールの追加方法については、CONTRIBUTING.md を参照してください。

バグを見つけましたか？Issue を作成してください。 アイデアがありますか？機能をリクエストしてください。

謝辞

GongRzhe による GongRzhe/Office-Word-MCP-Server を基盤として構築されています（MIT License）。

追加ライブラリ：python-docx · FastMCP · pywin32

プライバシー

このサーバーはお使いのローカルマシン上で完全に動作します。データの収集、送信、保存は一切行いません。詳しくはプライバシーポリシーをご覧ください。

サポート

• バグ報告： Issue を作成
• 機能リクエスト： 機能をリクエスト
• ディスカッション： GitHub Discussions

ライセンス

MIT ライセンス — 詳細はLICENSEをご覧ください。

スター履歴