# word-mcp-server **Repository Path**: helloword-open/word-mcp-server ## Basic Information - **Project Name**: word-mcp-server - **Description**: 让 AI 真正“看懂”并“可靠操作” Word 文档,首个基于 MCP 协议、具备结构化感知与 COM 安全契约的 Word 文档交互服务器。解决 AI Agent 操作 Word 时“失忆、漂移、崩溃”三大顽疾。 - **Primary Language**: TypeScript - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-06-17 - **Last Updated**: 2026-06-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: MCP, Word-MCP-Server, 文档处理 ## README > [English](./README.md) | [中文](./README.zh-CN.md) > ⚠️ **视频提示**:下方演示视频托管在 GitHub,Gitee 上可能无法播放。 > 可从仓库的 `assets/demo/demo.mp4` 下载后本地观看。 # Word MCP Server
## 是什么 让你的 AI 智能体直接操控 Microsoft Word。80 个工具,覆盖创建、编辑、排版、表格、图表、图片、书签、页眉页脚、批注等全流程。Word 以可见窗口运行,每条修改即时呈现,Ctrl+Z 全程有效。 > 需要已有 Microsoft Word 授权。不包含、不破解、不分发 Office 软件。 ## 做什么 | 场景 | 描述 | |------|------| | 周报月报 | Agent 拉取数据,写报告,排版,保存,一气呵成 | | 合同草拟 | 模板填入变量,生成正式合同,导出 PDF | | 学术论文 | 撰写结构化内容,插入表格图表,格式化引用 | | 自动化测试 | CI 流程中自动创建 Word 文档用于测试验证 | ## 兼容生态 | 生态 | 智能体 | |------|--------| | Claude | Claude Desktop、Claude Code | | OpenAI | ChatGPT Desktop | | IDE | Cursor、VS Code / GitHub Copilot、Trae | | AI 终端 | OpenCode | | 更多 | 任意 stdio MCP 客户端 | ## 为什么需要 - **80 个工具** — 文本、表格、图表、图片、页眉页脚、批注、书签,精准操控每个细节 - **流式 Markdown** — `start → block → end` 三步写文档,即时预览,字体/样式自动继承 - **自动光标管理** — 页眉/页脚/表格/标记操作后自动复位光标,无需手动调整位置 - **完全可撤销** — COM API 原生操作,搞砸了 Ctrl+Z 就行 - **安全内置** — 路径消毒、宏强制禁用、Zod 输入校验、限流、审计日志 --- ### ⚡ 快速开始 ```bash git clone https://github.com/HelloWorld-Open/word-mcp-server.git cd word-mcp-server npm install && npm run build ``` > 需要 MSVC Build Tools 编译 winax 原生模块。如失败请安装 VS 2022 Build Tools("使用 C++ 的桌面开发"工作负载)。 添加到 MCP 客户端配置: ```json { "mcpServers": { "word": { "command": "node", "args": ["path\\to\\word-mcp-server\\build\\parent.js"] } } } ``` 然后对 AI 说:*"帮我写一份周报到 Word"*。 ### 📖 更多 - [TOOLS.zh-CN.md](./TOOLS.zh-CN.md) — 80 工具速查 - [CONTEXT.md](./CONTEXT.md) — 架构与设计 - [.env.example](./.env.example) — 配置项 - [MIT License](./LICENSE)