🚀 办公室 Word-MCP 服务器

办公室 Word-MCP 服务器实现了模型上下文协议（MCP），可用于创建、读取和操作 Microsoft Word 文档。与 Claude for Desktop 或其他 MCP 客户端配合使用时，能对文档进行自动化处理，提升办公效率。

🚀 快速开始

办公室 Word-MCP 服务器是一个基于 Model Context Protocol (MCP) 的工具，可用于对 Word 文档进行自动化处理。使用前，请确保满足系统要求并完成安装步骤。

✨ 主要特性

• 文档管理：支持创建、读取、保存和关闭 Word 文档，方便对文档的全生命周期进行管理。
• 内容创建：可添加标题、段落、表格、图片和分页符，满足多样化的文档内容需求。
• 文本格式化：能够调整文本样式，如加粗、斜体、颜色等，还可查找并替换文本、删除段落。
• 表格格式化：可以设置表格边框、背景和其他属性，使表格更加美观。

📦 安装指南

系统要求

• 操作系统：Windows、Linux 或 macOS。
• Python 版本：3.6+。

安装步骤

1. 克隆项目仓库：

git clone https://github.com/your-repository.git

2. 安装依赖项：

pip install python-docx fastmcp

💻 使用示例

基础用法

# 添加标题
add_heading("example.docx", "这是一个标题", level=1)

# 添加段落
add_paragraph("example.docx", "这是第一段文字。")

# 添加表格
add_table("example.docx", 2, 2)

# 调整文本样式
format_text("example.docx", 0, 0, 5, bold=True, color="FF0000")

高级用法

# 配置 Claude for Desktop
# 打开 settings.json 文件，添加以下配置
# 启动服务器并连接到 Claude
{
    "mcp_server": "file:///path/to/server.py"
}

📚 详细文档

功能详情

文档管理

• create_document：创建新文档。
• open_document：打开现有文档。
• save_document：保存文档。
• close_document：关闭文档。

内容创建

• add_heading：添加标题。
• add_paragraph：添加段落。
• add_table：添加表格。
• add_picture：插入图片。
• add_page_break：插入分页符。

文本格式化

• format_text：调整文本样式（如加粗、斜体、颜色等）。
• search_and_replace：查找并替换文本。
• delete_paragraph：删除段落。

表格格式化

• format_table：设置表格边框、背景和其他属性。

API 文档

文档管理接口

• create_document(path: str) -> None：创建新文档，指定文件路径。
• open_document(path: str) -> None：打开现有文档。
• save_document() -> None：保存当前文档。

内容创建接口

• add_heading(text: str, level: int = 1) -> None：添加标题，指定文字和标题级别。

🔧 技术细节

本服务器基于 Model Context Protocol (MCP) 实现，与 Claude for Desktop 或其他 MCP 客户端配合使用，实现对 Word 文档的自动化处理。在处理文档时，会遇到样式缺失和权限问题，服务器会尝试创建缺失的样式或直接应用格式化，并提示用户确保对文件路径具有读写权限。

📄 许可证

本项目使用 MIT License，具体内容见 LICENSE 文件。

⚠️ 重要提示

此服务器与文档文件交互，请确保操作适当后再在 Claude for Desktop 等 MCP 客户端中确认。

💡 使用建议

若遇到样式缺失问题，服务器会尝试创建缺失的样式或直接应用格式化；若遇到权限问题，可使用 copy_document 创建可编辑副本。