Skip to main content
Glama

Install in Cursor

word-mcp-live

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

Live editing · Tracked changes · Per-action undo · 124 tools · Cross-platform

PyPI Python 3.11+ License: MIT Platform: Windows + macOS/Linux


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。犯错了?直接撤销。

  • 原生修订 — 真正的 Word 修订,带有你的名字,而不是 XML 技巧。

  • 线程化批注 — 像人类审阅者一样添加、回复、解决和删除批注。

  • 布局诊断 — 在格式问题变成打印灾难之前检测出来。

  • 公式和交叉引用 — 插入数学公式和自动更新的引用。

  • 124 个工具 — 最全面的 Word MCP 服务器。

Related MCP server: Word Document MCP Server

快速开始

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"
      }
    }
  }
}

一键安装: Install in 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 设置批注缩写。

两种模式

随处可用

实时编辑(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

不可用

配置

变量

默认值

描述

MCP_AUTHOR

"Author"

修订和批注的作者名称

MCP_AUTHOR_INITIALS

""

批注的作者缩写

MCP_TRANSPORT

stdio

传输类型:stdiossestreamable-http

MCP_HOST

0.0.0.0

绑定主机(用于 SSE/HTTP 传输)

MCP_PORT

8000

绑定端口(用于 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 的审阅面板中,锚定到指定的文本。

工具参考

124 个工具,涵盖两种模式——详见完整工具参考

类别

数量

跨平台(python-docx)

80

Windows 实时(COM 自动化)

44

macOS 实时(JXA 自动化)

40(44 个实时工具中的)

系统要求

  • Python 3.11+

  • python-docxfastmcpmsoffcrypto-tool(自动安装)

  • Windows 实时工具: Windows 10/11 + Microsoft Word + pywin32(自动安装)

  • macOS 实时工具: macOS + Microsoft Word for Mac(使用内置 JXA——无需额外依赖)

跨平台工具无需安装 Word 即可使用——只需要 python-docx。

贡献

开发环境、代码风格以及如何添加新工具,请参阅 CONTRIBUTING.md

发现 bug?提交 issue。有想法?请求功能

致谢

基于 GongRzhe/Office-Word-MCP-Server(作者 GongRzhe,MIT 许可证)构建。

其他库:python-docx · FastMCP · pywin32

隐私

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

支持

许可证

MIT 许可证——详见 LICENSE

Star 历史

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • AI document editing for agents: draft, edit, export .docx/PDF. 37 MCP tools; agent self-signup.

  • Persistent docs and memory for AI agents — read, write, organize & search a shared workspace.

  • SaaS intelligence for AI agents. 5 unified tools cover 1,000+ services with 91-96% token savings.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/trustypangolin/word-mcp-live'

If you have feedback or need assistance with the MCP directory API, please join our Discord server