Office-Word-MCP-服务器

这是一个用于创建、读取和操作Microsoft Word文档的模型上下文协议(MCP)服务器。该服务器使AI助手能够通过标准化接口处理Word文档，提供丰富的文档编辑功能。

概述

Office-Word-MCP-服务器实现了模型上下文协议，将Word文档操作作为工具和资源暴露出来。它充当AI助手和Microsoft Word文档之间的桥梁，支持文档创建、内容添加、格式设置和分析等功能。

该服务器采用模块化架构，将核心功能、工具和实用程序分离，使其具有高度的可维护性和可扩展性，便于未来增强功能。

示例

提示

输出

功能

文档管理

• 创建带有元数据的新Word文档
• 提取文本并分析文档结构
• 查看文档属性和统计信息
• 列出目录中的可用文档
• 创建现有文档的副本
• 将多个文档合并为单个文档
• 将Word文档转换为PDF格式

内容创建

• 添加不同级别的标题
• 插入可选样式的段落
• 创建带有自定义数据的表格
• 添加按比例缩放的图像
• 插入分页符
• 在文档中添加脚注和尾注
• 将脚注转换为尾注
• 自定义脚注和尾注样式

丰富文本格式设置

• 格式化特定文本部分（粗体、斜体、下划线）
• 更改文本颜色和字体属性
• 为文本元素应用自定义样式
• 在整个文档中搜索和替换文本

表格格式设置

• 使用边框和样式格式化表格
• 创建具有独特格式的标题行
• 应用单元格阴影和自定义边框
• 结构化表格以提高可读性

高级文档操作

• 删除段落
• 创建自定义文档样式
• 在整个文档中应用一致的格式
• 使用详细控制格式化特定范围的文本

文档保护

• 为文档添加密码保护
• 实现带可编辑区域的受限编辑
• 为文档添加数字签名
• 验证文档的真实性和完整性

安装

通过Smithery安装

要通过Smithery自动为Claude Desktop安装Office Word文档服务器：

npx -y @smithery/cli install @GongRzhe/Office-Word-MCP-Server --client claude

前提条件

• Python 3.8或更高版本
• pip包管理器

基本安装

# 克隆仓库
git clone https://github.com/GongRzhe/Office-Word-MCP-Server.git
cd Office-Word-MCP-Server

# 安装依赖项
pip install -r requirements.txt

使用设置脚本

或者，您可以使用提供的设置脚本，它处理：

• 检查前提条件
• 设置虚拟环境
• 安装依赖项
• 生成MCP配置

python setup_mcp.py

与Claude Desktop一起使用

配置

方法1：本地安装后

1. 安装后，将服务器添加到您的Claude Desktop配置文件中：

{
  "mcpServers": {
    "word-document-server": {
      "command": "python",
      "args": ["/path/to/word_mcp_server.py"]
    }
  }
}

方法2：无需安装（使用uvx）

1. 您还可以通过使用uvx包管理器配置Claude Desktop使用服务器而无需本地安装：

{
  "mcpServers": {
    "word-document-server": {
      "command": "uvx",
      "args": ["--from", "office-word-mcp-server", "word_mcp_server"]
    }
  }
}

2. 配置文件位置：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

3. 重新启动Claude Desktop以加载配置。

示例操作

配置后，您可以要求Claude执行以下操作：

• "创建一个名为'report.docx'的新文档，带有标题页"
• "向我的文档添加一个标题和三个段落"
• "插入一个带有销售数据的4x4表格"
• "将第2段中的'important'一词格式化为粗体和红色"
• "搜索并替换所有'old term'实例为'new term'"
• "为部分标题创建自定义样式"
• "对我的文档中的表格应用格式"

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)

故障排除

常见问题

1. 缺少样式

   • 某些文档可能缺少标题和表格操作所需的样式
   • 服务器将尝试创建缺失的样式或使用直接格式
   • 为获得最佳效果，请使用带有标准Word样式的模板

2. 权限问题

   • 确保服务器具有读取/写入文档路径的权限
   • 使用copy_document函数创建锁定文档的可编辑副本
   • 如果操作失败，请检查文件所有权和权限

3. 图像插入问题

   • 对于图像文件使用绝对路径
   • 验证图像格式兼容性（推荐JPEG、PNG）
   • 检查图像文件大小和权限

调试

通过设置环境变量启用详细日志记录：

export MCP_DEBUG=1  # Linux/macOS
set MCP_DEBUG=1     # Windows

贡献

欢迎贡献！请随时提交Pull Request。

1. 分叉仓库
2. 创建您的功能分支（git checkout -b feature/amazing-feature）
3. 提交您的更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开Pull Request

许可证

本项目根据MIT许可证授权 - 详情请参阅LICENSE文件。

致谢

• 模型上下文协议提供协议规范
• python-docx用于Word文档操作
• FastMCP提供Python MCP实现

---

注意：此服务器会与系统上的文档文件交互。在Claude Desktop或其他MCP客户端中确认请求的操作之前，请始终验证这些操作是否合适。