Office-Word-MCP-服务器
用于创建、读取和操作 Microsoft Word 文档的模型上下文协议 (MCP) 服务器。该服务器使 AI 助手能够通过标准化界面处理 Word 文档，并提供丰富的文档编辑功能。
概述
Office-Word-MCP-Server 实现了模型上下文协议 (MCP) ，将 Word 文档操作公开为工具和资源。它充当 AI 助手和 Microsoft Word 文档之间的桥梁，支持文档创建、内容添加、格式化和分析。
该服务器采用模块化架构，将关注点分为核心功能、工具和实用程序，使其具有高度的可维护性和可扩展性，以便在未来进行增强。
例子
提示
输出
特征
文档管理
- 使用元数据创建新的 Word 文档
- 提取文本并分析文档结构
- 查看文档属性和统计信息
- 列出目录中的可用文档
- 创建现有文档的副本
- 将多个文档合并为一个文档
- 将 Word 文档转换为 PDF 格式
内容创作
- 添加不同级别的标题
- 插入具有可选样式的段落
- 使用自定义数据创建表
- 添加按比例缩放的图像
- 插入分页符
- 向文档添加脚注和尾注
- 将脚注转换为尾注
- 自定义脚注和尾注样式
富文本格式
- 格式化特定的文本部分（粗体、斜体、下划线）
- 更改文本颜色和字体属性
- 将自定义样式应用于文本元素
- 在整个文档中搜索和替换文本
表格格式
- 使用边框和样式设置表格格式
- 创建具有不同格式的标题行
- 应用单元格底纹和自定义边框
- 构建表格以提高可读性
高级文档操作
- 删除段落
- 创建自定义文档样式
- 在整个文档中应用一致的格式
- 使用详细控制来格式化特定范围的文本
文档保护
- 为文档添加密码保护
- 使用可编辑部分实现限制编辑
- 向文档添加数字签名
- 验证文件的真实性和完整性
安装
先决条件
基本安装
# Clone the repository
git clone https://github.com/GongRzhe/Office-Word-MCP-Server.git
cd Office-Word-MCP-Server
# Install dependencies
pip install -r requirements.txt
使用安装脚本
或者，您可以使用提供的安装脚本来处理：
- 检查先决条件
- 设置虚拟环境
- 安装依赖项
- 生成 MCP 配置
与 Claude 桌面版一起使用
配置
方法 1：本地安装后
- 安装后，将服务器添加到您的 Claude for Desktop 配置文件中：
{
"mcpServers": {
"word-document-server": {
"command": "python",
"args": ["/path/to/word_mcp_server.py"]
}
}
}
方法二：无需安装（使用 uvx）
- 您还可以使用 uvx 包管理器将 Claude for Desktop 配置为使用服务器而无需本地安装：
{
"mcpServers": {
"word-document-server": {
"command": "uvx",
"args": ["--from", "office-word-mcp-server", "word_mcp_server"]
}
}
}
- 配置文件位置：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - Windows：
%APPDATA%\Claude\claude_desktop_config.json
- 重新启动 Claude for Desktop 以加载配置。
示例操作
配置完成后，您可以要求 Claude 执行如下操作：
- “创建一个名为‘report.docx’的新文档，并添加标题页”
- “在我的文档中添加一个标题和三个段落”
- “插入包含销售数据的 4x4 表格”
- 将第 2 段中的“重要”一词格式化为粗体和红色
- “搜索并将所有‘旧术语’替换为‘新术语’”
- “为章节标题创建自定义样式”
- “将格式应用于我的文档中的表格”
API 参考
文档创建和属性
create_document(filename, title=None, author=None)
get_document_info(filename)
get_document_text(filename)
get_document_outline(filename)
list_available_documents(directory=".")
copy_document(source_filename, destination_filename=None)
convert_to_pdf(filename, output_filename=None)
内容添加
add_heading(filename, text, level=1)
add_paragraph(filename, text, style=None)
add_table(filename, rows, cols, data=None)
add_picture(filename, image_path, width=None)
add_page_break(filename)
内容提取
get_document_text(filename)
get_paragraph_text_from_document(filename, paragraph_index)
find_text_in_document(filename, text_to_find, match_case=True, whole_word=False)
文本格式
format_text(filename, paragraph_index, start_pos, end_pos, bold=None,
italic=None, underline=None, color=None, font_size=None, font_name=None)
search_and_replace(filename, find_text, replace_text)
delete_paragraph(filename, paragraph_index)
create_custom_style(filename, style_name, bold=None, italic=None,
font_size=None, font_name=None, color=None, base_style=None)
表格格式
format_table(filename, table_index, has_header_row=None,
border_style=None, shading=None)
故障排除
常见问题
- 缺少样式
- 某些文档可能缺少标题和表格操作所需的样式
- 服务器将尝试创建缺失的样式或使用直接格式化
- 为获得最佳效果，请使用具有标准 Word 样式的模板
- 权限问题
- 确保服务器具有读取/写入文档路径的权限
- 使用
copy_document函数创建锁定文档的可编辑副本 - 如果操作失败，请检查文件所有权和权限
- 图像插入问题
- 对图像文件使用绝对路径
- 验证图像格式兼容性（推荐 JPEG、PNG）
- 检查图像文件大小和权限
调试
通过设置环境变量启用详细日志记录：
export MCP_DEBUG=1 # Linux/macOS
set MCP_DEBUG=1 # Windows
贡献
欢迎贡献代码！欢迎提交 Pull 请求。
- 分叉存储库
- 创建你的功能分支（
git checkout -b feature/amazing-feature ） - 提交您的更改（
git commit -m 'Add some amazing feature' ） - 推送到分支（
git push origin feature/amazing-feature ） - 打开拉取请求
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。
致谢
注意：此服务器会与您系统上的文档文件进行交互。请务必在 Claude for Desktop 或其他 MCP 客户端中确认请求的操作是否正确。