Office-Word-MCP-Server
A Model Context Protocol (MCP) server for creating, reading, and manipulating Microsoft Word documents.
This server enables AI assistants to work with Word documents through a standardized interface, providing rich document editing capabilities.
Overview
Office-Word-MCP-Server 实现了 Model Context Protocol,
将 Word 文档的操作封装为工具和资源,成为 AI 与 Word 之间的'翻译官'。
它支持文档创建、内容添加、格式化和分析,架构模块化,可扩展性强,维护方便。
Example
Prompt
Output
Features 功能亮点
Document Management(文档管理)
- 创建新 Word 文档(支持元数据)
- 提取文本、分析结构
- 查看文档属性与统计信息
- 列出目录中的文档
- 复制、合并文档
- Word 转 PDF
Content Creation(内容创建)
- 添加不同级别的标题
- 插入段落(可选样式)
- 创建自定义数据表格
- 插入图片(保持比例)
- 插入分页符、脚注、尾注
- 自定义专业表格、提示框、技术文档布局
Rich Text Formatting(富文本格式)
- 对指定文本加粗、斜体、下划线
- 修改颜色、字体属性
- 自定义样式
- 全文搜索替换
- 表格单元格内文字格式化
Table Formatting(表格格式)
- 设置边框与样式
- 表头高亮、单元格底色
- 交替行配色
- 单元格合并、对齐、填充
- 列宽管理与自动适应
Advanced Document Manipulation(高级操作)
Document Protection(文档保护)
安装与配置
方式 1:Smithery 自动安装(Claude Desktop)
npx -y @smithery/cli install @GongRzhe/Office-Word-MCP-Server --client claude
方式 2:本地安装
git clone https://github.com/GongRzhe/Office-Word-MCP-Server.git
cd Office-Word-MCP-Server
pip install -r requirements.txt
方式 3:使用安装脚本
python setup_mcp.py
配置到 Claude Desktop
方法 1:本地安装后
{"mcpServers":{"word-document-server":{"command":"python","args":["/path/to/word_mcp_server.py"]}}}
方法 2:无需安装(uvx)
{"mcpServers":{"word-document-server":{"command":"uvx","args":["--from","office-word-mcp-server","word_mcp_server"]}}}
常用操作示例
- '创建一个名为 report.docx 的新文档,并加上封面'
- '插入一个 4x4 的销售数据表'
- '将第二段的'重要'标红加粗'
- '搜索替换所有的'旧术语'为'新术语''
- '应用表格交替行颜色'
- '提取所有评论并按作者分类'
API 样例
创建文档
create_document(filename, title=None, author=None)
添加内容
add_heading(filename, text, level=1)
add_paragraph(filename, text, style=None)
add_table(filename, rows, cols, data=None)
格式化
format_text(filename, paragraph_index, start_pos, end_pos, bold=True, color="FF0000")
表格高级操作
highlight_table_header(filename, table_index, header_color="4472C4", text_color="FFFFFF")
apply_table_alternating_rows(filename, table_index, color1="FFFFFF", color2="F2F2F2")
常见问题
- 样式缺失:建议使用标准 Word 模板
- 权限问题:检查文件读写权限
- 图片插入:建议使用绝对路径并保证格式兼容
- 表格索引:确保行列索引合法(0 基)
总结
有了 Office-Word-MCP-Server,AI 就成了你的 Word 专属助理,能写、能排版、能美化,还能管控权限。
无论是数据分析报告、会议纪要、还是技术文档,都可以用一句自然语言让 AI 搞定。