Office-Word-MCP-服务器

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

概述

Office-Word-MCP-Server 实现了模型上下文协议 (MCP) ，将 Word 文档操作公开为工具和资源。它充当 AI 助手和 Microsoft Word 文档之间的桥梁，支持文档创建、内容添加、格式化和分析。

例子

提示

输出

特征

文档管理

使用元数据创建新的 Word 文档
提取文本并分析文档结构
查看文档属性和统计信息
列出目录中的可用文档
创建现有文档的副本

内容创作

添加不同级别的标题
插入具有可选样式的段落
使用自定义数据创建表
添加按比例缩放的图像
插入分页符

富文本格式

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

表格格式

使用边框和样式设置表格格式
创建具有不同格式的标题行
应用单元格底纹和自定义边框
构建表格以提高可读性

高级文档操作

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

安装

先决条件

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

基本安装

# 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 配置

python setup_mcp.py

与 Claude 桌面版一起使用

配置

方法 1：本地安装后

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

{
  "mcpServers": {
    "word-document-server": {
      "command": "python",
      "args": [
        "/path/to/word_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)

内容添加

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)

文本格式

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 文件。

致谢

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

注意：此服务器会与您系统上的文档文件进行交互。请务必在 Claude for Desktop 或其他 MCP 客户端中确认请求的操作是否正确。

Office Word MCP Server

Office-Word-MCP-服务器

概述

例子

提示

输出

特征

文档管理

内容创作

富文本格式

表格格式

高级文档操作

安装

先决条件

基本安装

使用安装脚本

与 Claude 桌面版一起使用

配置

方法 1：本地安装后

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

示例操作

API 参考

文档创建和属性

内容添加

文本格式

表格格式

故障排除

常见问题

调试

贡献

执照

致谢

Tools

Related Resources