README
🚀 Docx MCP 服务
Docx MCP 服务是基于 FastMCP 库的文档处理服务,支持借助 Cursor 的 AI 助手对 Word 文档进行创建、编辑和管理等操作,极大提升了文档处理的效率和便捷性。
🚀 快速开始
确保已安装 Python 3.10+,然后安装以下依赖项:
pip3 install python-docx mcp
安装完成后,您可以运行以下命令来测试服务:
python3 server.py
然后您可以在 Cursor 中使用自然语言调用这些功能。
✨ 主要特性
- 完整的文档操作:支持创建、打开、保存文档,以及添加、编辑和删除内容。
- 格式设置:支持设置字体、颜色、大小、对齐方式及其他格式选项。
- 表格处理:支持创建、编辑、合并和拆分表格单元格。
- 图片插入:支持插入图片并设置其大小。
- 版式控制:支持设置页面边距、添加页眉页脚和其他版式元素。
- 查询功能:支持获取文档信息、段落内容和表格数据。
- 方便的编辑功能:支持查找和替换功能。
- 节内容编辑:支持在特定部分替换内容同时保留原始格式和样式。
📦 安装指南
在 Cursor 中作为 MCP 服务使用
- 打开 Cursor 并进入设置。
- 进入
功能 > MCP 服务器部分。 - 点击
添加新的 MCP 服务器。 - 填写以下信息:
- 名称:MCP_DOCX
- 类型:命令
- 命令:
python3 /path/to/MCP_dox/server.py(将/path/to/MCP_dox替换为实际的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_section, replace_content_in_section |
| 其他功能 | clear_document |
该服务支持在特定部分替换内容同时保留原始格式和样式。
微信扫一扫