🚀 办公室 Word-MCP 服务器
这是一个实现模型上下文协议（MCP）的服务器，它能够创建、读取和操作 Microsoft Word 文档。当与 Claude for Desktop 或其他 MCP 客户端配合使用时，可对文档进行自动化处理，极大提升办公效率。
🚀 快速开始
本服务器基于 Model Context Protocol (MCP) 实现，能与 Claude for Desktop 等 MCP 客户端协作，对 Word 文档进行自动化处理。下面是使用前的系统要求和安装步骤。
系统要求
- 操作系统：Windows、Linux 或 macOS。
- Python 版本：3.6+。
安装步骤
- 克隆项目仓库：
git clone https://github.com/your-repository.git
- 安装依赖项：
pip install python-docx fastmcp
✨ 主要特性
本服务器支持以下功能：
- 文档管理：可创建、读取和操作 Word 文档。
- 内容创建：能添加标题、段落、表格和图片。
- 文本格式化：可调整字体样式、大小、颜色等。
- 表格格式化：能设置表格边框、背景和其他属性。
💻 使用示例
以下是服务器功能的示例：
基础用法
# 添加标题
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")
📚 详细文档
功能详情
文档管理
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：设置表格边框、背景和其他属性。
使用说明
配置 Claude for Desktop
- 打开
settings.json文件。 - 添加以下配置：
{
"mcp_server": "file:///path/to/server.py"
}
- 启动服务器并连接到 Claude。
API 文档
文档管理接口
create_document(path: str) -> None：创建新文档，指定文件路径。open_document(path: str) -> None：打开现有文档。save_document() -> None：保存当前文档。
内容创建接口
add_heading(text: str, level: int = 1) -> None：添加标题，指定文字和标题级别。
🔧 技术细节
故障排除
常见问题
- 样式缺失：部分文档可能缺少必要的样式，服务器会尝试创建缺失的样式或直接应用格式化。
- 权限问题：确保服务器对文件路径具有读写权限，可使用
copy_document创建可编辑副本。
🤝 贡献指南
欢迎提交 Pull Request！贡献步骤如下：
- 叉仓库。
- 创建功能分支。
- 提交更改。
- 推送到远程仓库。
- 提交拉取请求。
📄 许可证
本项目使用 MIT License，具体内容见 LICENSE 文件。
⚠️ 重要提示
此服务器与文档文件交互，请确保操作适当后再在 Claude for Desktop 等 MCP 客户端中确认。