word-mcp-live
word-mcp-live
Word文書を開いたまま編集できる唯一のMCPサーバー
ライブ編集 · 変更履歴 · 操作単位の元に戻す · 124ツール · クロスプラットフォーム
word-mcp-liveは、MCPをサポートするあらゆるAIアシスタントにMicrosoft Wordの完全な制御を提供します。文書を開き、AIに必要なことを伝えるだけで、書式設定、変更履歴、コメントなど、すべてが実行されます。変更は開いている文書にライブで反映されます。
word-mcp-liveなしの場合
AIは文書について話し合うことはできても、触ることはできない
AIとWordの間でコピー&ペーストが必要で、書式が失われる
変更履歴? 後から手動で行う必要がある
編集のたびに保存 → 閉じる → 処理 → 開き直す
word-mcp-liveありの場合
「ABC CorpをXYZ Ltdに置き換える変更履歴を追加して」— 完了
変更は開いているWord文書にライブで反映される
AIによる編集はすべてCtrl+Zひとつで元に戻せる
XMLハックではなく、自分の名前が付いた本物の変更履歴
動作デモ
https://github.com/user-attachments/assets/fbb09af4-1e25-4e49-94d0-45b363278810
他との違い
ライブ編集 — Wordで開いている文書をそのまま編集。保存・閉じる・開き直すのサイクルは不要。
完全な元に戻す — AIによる操作はすべてCtrl+Zひとつで元に戻せます。間違えた? 元に戻すだけです。
ネイティブの変更履歴 — XMLハックではなく、自分の名前が付いた本物のWordの変更履歴。
スレッド形式のコメント — 人間のレビュアーのようにコメントの追加、返信、解決、削除が可能。
レイアウト診断 — 印刷で問題になる前に書式の問題を検出。
数式と相互参照 — 数式や自動更新される参照の挿入が可能。
124ツール — 最も包括的なWord MCPサーバー。
Related MCP server: word-mcp-live
クイックスタート
pip install word-mcp-liveまたはソースからインストール:
git clone https://github.com/ykarapazar/word-mcp-live.git
cd word-mcp-live
pip install -e .クライアントのインストール
claude_desktop_config.json に追加:
{
"mcpServers": {
"word": {
"command": "uvx",
"args": ["word-mcp-live"],
"env": {
"MCP_AUTHOR": "Your Name",
"MCP_AUTHOR_INITIALS": "YN"
}
}
}
}.mcp.json に追加:
{
"mcpServers": {
"word": {
"command": "uvx",
"args": ["word-mcp-live"],
"env": {
"MCP_AUTHOR": "Your Name",
"MCP_AUTHOR_INITIALS": "YN"
}
}
}
}ワンクリック: このページ上部のインストールボタンをクリック。
手動: ~/.cursor/mcp.json に追加:
{
"mcpServers": {
"word": {
"command": "uvx",
"args": ["word-mcp-live"],
"env": {
"MCP_AUTHOR": "Your Name",
"MCP_AUTHOR_INITIALS": "YN"
}
}
}
}ワンクリック: VS Codeにインストール
手動: VS Codeの settings.json に追加:
{
"mcp": {
"servers": {
"word": {
"command": "uvx",
"args": ["word-mcp-live"],
"env": {
"MCP_AUTHOR": "Your Name",
"MCP_AUTHOR_INITIALS": "YN"
}
}
}
}
}~/.codeium/windsurf/mcp_config.json に追加:
{
"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"
}
}
}
}注: Dockerモードはクロスプラットフォームツールのみをサポートします。ライブ編集にはネイティブのWindowsインストールが必要です。
MCP_AUTHORは変更履歴とコメントに表示される名前を設定します(デフォルト:"Author")。MCP_AUTHOR_INITIALSはコメントのイニシャルを設定します。
2つのモード
どこでも動作 | ライブ編集(Wordを開いた状態) | |
機能 | 保存済みの.docxファイルの作成と編集 | Wordで作業中に文書をライブで編集 |
プラットフォーム | Windows、macOS、Linux | Windows(COM)およびmacOS(JXA) |
元に戻す | ファイルレベルの保存 | 操作単位のCtrl+Z(Windows)/操作単位の元に戻す(macOS) |
最適な用途 | バッチ処理、文書生成 | 対話的な編集、書式設定、レビュー |
両方のモードは連携して動作します。AIがタスクに応じて適切なモードを選択します。
macOSライブ編集(v1.5.0の新機能)
ライブツールはJavaScript for Automation(JXA)経由でmacOSでも動作するようになりました。ツール名もパラメータも同じで、サーバーがプラットフォームを検出して適切な自動化バックエンドを使用します。
機能 | Windows | macOS |
テキストの読み取り/書き込み/検索/置換 | COM | JXA |
書式設定(太字、フォント、スタイル) | COM | JXA |
変更履歴とリビジョン | COM | JXA |
コメント(追加、削除、一覧表示) | COM | JXA |
テーブル(読み取り、書き込み、行追加) | COM | JXA |
ページレイアウト、ヘッダー、ブックマーク | COM | JXA |
数式、相互参照 | COM | JXA |
スレッド形式のコメント返信 | COM | 利用不可 |
コメントの解決/未解決 | COM | 利用不可 |
元に戻す履歴の検査 | COM | 利用不可 |
透かし | COM | 利用不可 |
設定
変数 | デフォルト | 説明 |
|
| 変更履歴とコメントに表示される作成者名 |
|
| コメントに表示される作成者のイニシャル |
|
| トランスポートタイプ: |
|
| バインドするホスト(SSE/HTTPトランスポート用) |
|
| バインドするポート(SSE/HTTPトランスポート用) |
リモートデプロイについては、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-docx) | 80 |
Windowsライブ(COM自動化) | 44 |
macOSライブ(JXA自動化) | 40(44のライブツールのうち) |
要件
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/Office-Word-MCP-Server(GongRzhe作、MITライセンス)を基に構築されています。
追加ライブラリ: python-docx · FastMCP · pywin32
プライバシー
このサーバーは完全にローカルマシン上で動作します。データの収集、送信、保存は一切行われません。完全なプライバシーポリシーを参照してください。
サポート
バグ報告: Issueを開く
機能リクエスト: 機能をリクエスト
ディスカッション: GitHub Discussions
ライセンス
MITライセンス — 詳細はLICENSEを参照してください。
スター履歴
This server cannot be deployed
Maintenance
Related MCP Connectors
Collaborative word processor you can use with your agent.
AI document editing for agents: draft, edit, export .docx/PDF. 37 MCP tools; agent self-signup.
Create and manage documents, spreadsheets, and presentations from your AI assistant.
Create real Word .docx files from your AI chat: proposals, quotes, contracts, statements of work.
Related MCP Servers
- AlicenseBqualityNot gradedmaintenanceEnables AI assistants to create, read, and manipulate Microsoft Word documents with comprehensive formatting, table creation, content management, and document protection capabilities. Supports advanced operations like merging documents, PDF conversion, and rich text formatting through a standardized interface.32MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to edit Microsoft Word documents live while they are open, with full support for tracked changes, comments, formatting, and 124 tools.1,108 PyPI228MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to directly read, edit, and manipulate Word documents, supporting image and table operations, paragraph editing, and search/replace.202MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to create, read, and manipulate Microsoft Word documents with rich editing capabilities.MIT