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 撤销。操作有误？直接撤销即可。
• 原生修订 — 创建真正的 Word 修订，并显示你的姓名，而不是耍 XML 把戏。
• 线程式评论 — 像人工审阅者一样添加、回复、解决和删除评论。
• 版式诊断 — 在格式问题酿成打印事故之前将其检测出来。
• 公式和交叉引用 — 插入数学公式和自动更新的引用。
• 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 用于设置评论中显示的姓名缩写。

两种模式

两种模式可以配合使用。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 的“审阅”窗格中，并锚定到指定文本。

工具参考

两种模式共提供 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。

发现错误？提交问题。 有想法？申请功能。

致谢

本项目基于 GongRzhe 编写的 GongRzhe/Office-Word-MCP-Server 构建（MIT License）。

其他库：python-docx · FastMCP · pywin32

隐私

此服务完全在你的本地计算机上运行。不会收集、传输或存储任何数据。请参阅完整的隐私政策。

支持

• 问题报告：提交问题
• 功能请求：请求新功能
• 讨论：GitHub 讨论区

许可证

MIT 许可证 — 详情请参阅 LICENSE。

Star 历史