Docx MCP 服务

English |中文

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

特征

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

安装依赖项

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

用法

在 Cursor 中用作 MCP 服务

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

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

• “创建一个新的Word文档并将其保存到桌面”
• “添加 3 级标题”
• “插入一个 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 许可证