Docx MCP 服务

English | 中文

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

功能特性

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

安装依赖

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

pip3 install python-docx mcp

使用方法

在 Cursor 中作为 MCP 服务使用

1. 打开 Cursor 并进入设置
2. 找到 Features > MCP Servers 部分
3. 点击 Add new MCP server
4. 填写以下信息：
   • Name: MCP_DOCX
   • Type: Command
   • Command: 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 许可证