🚀 Docx MCP 服务
Docx MCP 服务是一个基于 FastMCP 库的 Docx 文档处理服务，支持通过 Cursor 中的 AI 助手创建、编辑和管理 Word 文档，为用户提供便捷的文档处理体验。
🚀 快速开始
Docx MCP 服务可让你在 Cursor 的 AI 助手中轻松操作 Word 文档。按以下步骤添加服务后，就能用自然语言进行如创建新文档、添加标题、插入表格等操作。
✨ 主要特性
- 完整的文档操作：支持创建、打开、保存文档，以及添加、编辑和删除内容。
- 格式设置：支持设置字体、颜色、大小、对齐方式等格式选项。
- 表格处理：支持创建、编辑、合并和拆分表格单元格。
- 图片插入：支持插入图片并设置其大小。
- 版式控制：支持设置页面边距、添加页面断裂和其他版式元素。
- 查询功能：支持检索文档信息、段落内容和表格数据。
- 方便的编辑：支持查找和替换功能。
- 节编辑：支持在特定部分替换内容，同时保留原始格式和样式。
📦 安装指南
确保安装了 Python 3.10+，然后安装以下依赖项：
pip3 install python-docx mcp
💻 使用示例
基础用法
在 Cursor 中作为 MCP 服务使用：
- 打开 Cursor 并进入设置。
- 进入
功能 > MCP 服务器部分。 - 点击
添加新的 MCP 服务器。 - 填写以下信息：
- 名称：MCP_DOCX
- 类型：命令
- 命令：
python3 /path/to/MCP_dox/server.py（将路径替换为您实际的 server.py 路径）
- 点击
添加以添加服务。
添加完成后，您可以在 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_content_in_section，保留原始格式和样式 - 其他：
set_header_and_footer,add_watermark
排版能力
- 文本层次：支持处理标题、正文等不同层次的文本。
- 页面布局：支持设置页眉、页脚、水印和分节符。
- 字体样式：支持调整字体、字号、颜色和对齐方式。
- 表格格式：支持调整表格边距、行高和列宽。
- 分页控制：支持添加分页符并处理奇数页。
🔧 技术细节
服务使用 Python-docx 处理 Word 文档，并通过 FastMCP 库与 AI 助手通信。它解析用户指令，执行相应的文档操作，并返回结果。server.py 是核心实现文件，负责解析用户指令并与文档处理逻辑交互。该服务支持扩展以满足更多高级需求，同时提供了故障排除步骤以帮助解决常见问题。
📄 许可证
该服务采用 MIT License，允许自由使用和修改。
⚠️ 重要提示
在使用服务前，请确保安装了正确的 Python 版本（3.10+），检查依赖项是否正确安装，确保路径配置正确，若遇到问题可查看控制台输出获取更多信息。
💡 使用建议
若需要更多高级功能，可对服务进行扩展开发。在操作过程中，可充分利用支持的自然语言指令，提高文档处理效率。