← 返回目录

Word MCP Live

社区

唯一能实时编辑打开的 Word 文档的 MCP 服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 团队协作第 20 / 55
Stars: ★ 230 热门
传输方式: stdio（本地进程）
运行环境: Python 3.11+ · Docker
凭据: 无需凭据
许可证: MIT
最近提交: 5 天前
工具数: 3

57FMRS · C

Word MCP Live 提供了最全面的 Word 编辑能力，尤其突出实时编辑和跟踪更改。它适用于需要 AI 辅助进行文档协作和格式化的场景，但实时功能在 Windows 和 macOS 上有所差异，且需要本地安装。

最强项 · 安装易用性 13/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

11/20

维护活跃度

10/20

文档质量

13/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: 静态审查中未发现源码中明显的矛盾或糟糕的错误处理。README声称有124个工具，但server.json的packages部分只列出了PyPI包，没有工具列表。未提供测试和CI配置作为执行证据，因此大量声称无法验证。文档中声称docker模式仅支持跨平台工具，但README并未明确说明本地实时编辑的模式选择逻辑，这也未验证。由于没有提供可复现的测试证据，可靠性得分上限为12。
安全与权限 11/20: 未发现恶意代码、凭据窃取或数据外传的证据。环境变量MCP_AUTHOR和MCP_AUTHOR_INITIALS为非必需且非机密。README声称完全本地运行。但corss-platform和live工具存在导入和执行本地文件的行为，如通过文件名参数打开文件，容易受到路径穿越等攻击，可能导致任意文件访问。需要明确权限边界和防范措施，但安全声明和详细机制缺失，未提供安全文档或审计。因此，低于满分。
维护活跃度 10/20: 仓库活跃，有16个issue，但未提供issue响应细节。版本1.3.0与README提及的1.5.0不一致，可能存在发布管理问题。有MIT许可，但未找到维护者联系方式或安全响应渠道。静态审查无法验证提交频率和依赖更新，因此不能认为维护水平很高。
文档质量 13/20: README提供大量安装示例、两个模式说明和工具列表链接，但未包含完整工具参数、限制、成本或故障排除。工具数量声称124个，但文档中仅给出有限示例。README声称macOS实时编辑支持某些功能，但表格中列出不支持的功能存在差异，例如线程评论和撤销历史在macOS上不可用，但README声称支持，文档中未指出这些限制。因此文档质量中等偏上。
安装易用性 13/20: 提供了多种客户端的配置示例，包括Claude Desktop、Cursor等。但setup评分上限为15，因为未提供可验证的CI和测试证据。安装步骤对于非Python用户可能过于复杂（需要uvx或pip），平台依赖性（如Windows COM和macOS JXA）未在安装示例中充分说明。尽管有示例，但缺少平台兼容性常见问题的说明。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件

适合谁

需要与 Word 实时交互的编辑场景（Windows/macOS）。
希望 AI 产生可审阅的跟踪更改和评论的内容协作。
需要跨平台创建和编辑 .docx 文件（无需 Word 安装）。

不适合谁

需要完全跨平台实时功能（部分实时功能仅限 Windows，macOS 部分受限）。
需要在线协作或同步的团队（服务器完全本地运行）。
需要图形界面或非开发环境的普通用户。

所需权限

访问本地文件系统，读取和写入 .docx 文件。
通过 COM（Windows）或 JXA（macOS）自动化控制 Microsoft Word 进程。
可能修改文档内容，包括添加跟踪更改、评论、格式等。

风险与副作用

AI 可能意外修改错误内容，因此建议使用跟踪更改和撤销功能。
实时编辑依赖 Word 自动化，可能受 Word 版本或权限影响。
仅限本地运行，无数据收集，但需注意文档内容隐私。

安装接入

准备工作

运行环境：Python 3.11+ · Docker

其他可选配置项（5 个）

MCP_AUTHOR 可选修订和批注上显示的作者名，默认 "Author"，无需额外获取。

MCP_AUTHOR_INITIALS 可选批注中显示的作者姓名缩写，默认为空，自行填写即可。

MCP_TRANSPORT 可选传输类型：stdio、sse 或 streamable-http，默认 stdio。

MCP_HOST 可选 SSE/HTTP 传输时的绑定主机，默认 0.0.0.0。

MCP_PORT 可选 SSE/HTTP 传输时的绑定端口，默认 8000。

安装 Python 3.11+。
运行 pip install word-mcp-live。
在客户端配置中添加上下文，例如 Claude Desktop 的 claude_desktop_config.json，使用 uvx 命令。可选设置环境变量 MCP_AUTHOR 和 MCP_AUTHOR_INITIALS。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add word -e 'MCP_AUTHOR=Your Name' -e MCP_AUTHOR_INITIALS=YN -- uvx word-mcp-live

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

添加配置并重启客户端后，让 AI 用 get_document_text 读取一个 .docx 文件；该工具应出现在客户端工具列表中，并返回文档的段落内容。

常见排障

确保 Python 3.11+ 和 Word 已安装（实时工具需要）。
对于 Windows，确保 pywin32 已安装；macOS 使用内置 JXA，无需额外依赖。
如果连接失败，检查 MCP 配置中的 `uvx` 命令是否存在，以及环境变量是否正确设置。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

读取 C:/Documents/report.docx 的文本并总结各标题。
把 report.docx 中所有 'ABC Corporation' 替换为 'XYZ Ltd'，并以修订（tracked change）方式记录。
在 contract.docx 的 'payment within 30 days' 处添加一条批注，询问是否延长到 45 天。
把所有标题格式化为 Cambria 13pt 加粗并添加自动编号。

工具能力 3

get_document_text 只读

读取文档的全部段落文本及其样式。

word_live_replace_text 写入

在打开的 Word 文档中查找并替换文本，可选跟踪更改。

add_comment 写入

在文档中指定文本处添加评论。

使用场景

让 AI 起草合同并添加跟踪更改供同事审阅。

在打开的 Word 文档中实时进行格式调整、评论和内容替换。

批量处理多个 .docx 文件，如生成报告或目录。

支持客户端

Claude Desktop

Claude Code

Cursor

VS Code

Windsurf

依据项目文档列出，未经本站实测。

详细介绍

Word MCP Live 是一个 MCP 服务器，让 AI 助手（如 Claude、Cursor）能够通过 MCP 协议完全控制 Microsoft Word。它支持实时编辑（Word 打开时直接修改）、跟踪修订、评论、撤销操作等。提供 124 个工具，涵盖跨平台（python-docx）和实时（Windows COM、macOS JXA）两种模式。它允许 AI 以你的名义添加跟踪更改和评论，且每次操作都可以用 Ctrl+Z 撤销。