🚀 Docx MCP 服务

Docx MCP 服务是一个基于 FastMCP 库的 Docx 文档处理服务，支持通过 Cursor 中的 AI 助手创建、编辑和管理 Word 文档，为用户提供便捷的文档处理体验。

🚀 快速开始

Docx MCP 服务可让你在 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_content_in_section，保留原始格式和样式
• 其他：set_header_and_footer, add_watermark

排版能力

• 文本层次：支持处理标题、正文等不同层次的文本。
• 页面布局：支持设置页眉、页脚、水印和分节符。
• 字体样式：支持调整字体、字号、颜色和对齐方式。
• 表格格式：支持调整表格边距、行高和列宽。
• 分页控制：支持添加分页符并处理奇数页。

🔧 技术细节

服务使用 Python-docx 处理 Word 文档，并通过 FastMCP 库与 AI 助手通信。它解析用户指令，执行相应的文档操作，并返回结果。server.py 是核心实现文件，负责解析用户指令并与文档处理逻辑交互。该服务支持扩展以满足更多高级需求，同时提供了故障排除步骤以帮助解决常见问题。

📄 许可证

该服务采用 MIT License，允许自由使用和修改。

⚠️ 重要提示

在使用服务前，请确保安装了正确的 Python 版本（3.10+），检查依赖项是否正确安装，确保路径配置正确，若遇到问题可查看控制台输出获取更多信息。

💡 使用建议

若需要更多高级功能，可对服务进行扩展开发。在操作过程中，可充分利用支持的自然语言指令，提高文档处理效率。