Docx MCP 服务

English | 中文

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

特性

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

安装依赖

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

pip3 install python-docx mcp

使用方法

作为 MCP 服务在 Cursor 中使用

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

添加后，您可以在 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 许可证