Docx MCP服务

English | 中文

基于FastMCP库的Docx文档处理服务，支持使用Cursor中的AI助手创建、编辑和管理Word文档。

功能

• 完整的文档操作：支持创建、打开、保存文档，以及添加、编辑和删除内容
• 格式设置：支持设置字体、颜色、大小、对齐方式等格式选项
• 表格处理：支持创建、编辑、合并和拆分表格单元格
• 图片插入：支持插入图片并设置其大小
• 布局控制：支持设置页边距、添加分页符等布局元素
• 查询功能：支持检索文档信息、段落内容和表格数据
• 便捷编辑：支持查找和替换功能
• 部分编辑：支持在保留原始格式和样式的前提下替换特定部分的内容

安装依赖

确保已安装Python 3.10+，然后安装以下依赖：

pip3 install python-docx mcp

使用方法

在Cursor中作为MCP服务使用

1. 打开Cursor并进入设置
2. 找到功能 > MCP服务器部分
3. 点击添加新的MCP服务器
4. 填写以下信息：
   • 名称：MCP_DOCX
   • 类型：命令
   • 命令：python3 /path/to/MCP_dox/server.py（替换为您实际的server.py路径）
5. 点击添加以添加该服务

添加后，您可以在Cursor的AI助手中使用自然语言来操作Word文档，例如：

• "创建一个新的Word文档并保存到桌面"
• "添加一个三级标题"
• "插入一个3x4的表格并填充数据"
• "将第二段设置为粗体并居中对齐"

支持的操作

该服务支持以下操作：

• 文档管理：create_document，open_document，save_document
• 内容添加：add_paragraph，add_heading，add_table，add_picture
• 内容编辑：edit_paragraph，delete_paragraph，delete_text
• 表格操作：add_table_row，delete_table_row，edit_table_cell，merge_table_cells，split_table
• 布局控制：add_page_break，set_page_margins
• 查询功能：get_document_info，get_paragraphs，get_tables，search_text
• 文件操作：create_document，open_document，save_document，save_as_document，create_document_copy
• 部分编辑：replace_section，edit_section_by_keyword
• 其他功能：find_and_replace，search_and_replace（带有预览功能）

工作原理

1. 该服务使用Python-docx库来处理Word文档
2. 通过FastMCP库实现MCP协议与AI助手通信
3. 处理请求并返回格式化的响应
4. 支持完整的错误处理和状态报告

排版能力

该服务具有良好的排版理解能力：

• 文本层次：支持标题级别（1-9）和段落组织
• 页面布局：支持设置页边距
• 视觉元素：支持字体样式（粗体、斜体、下划线、颜色）和对齐方式
• 表格布局：支持创建表格、合并单元格、拆分表格和设置表格格式
• 分页控制：支持添加分页符

开发说明

• server.py - 使用FastMCP库实现MCP服务的核心代码

故障排除

如果您在Cursor中遇到问题，请尝试以下步骤：

1. 确保正确安装了Python 3.10+
2. 确保正确安装了python-docx和mcp库
3. 检查服务器路径是否正确
4. 重新启动Cursor应用程序

注意事项

• 确保正确安装了python-docx和mcp库
• 确保路径中的中文字符能够被正确处理
• 使用绝对路径可以避免路径解析问题

许可证

MIT许可证