AI导哈

Word文档处理服务

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

  • by MeterLong
  • Python
  • 本地部署
  • 192 星标
  • 更新于
在 GitHub 查看 MeterLong/MCP-Doc

使用说明

Docx MCP服务

英语 | 中文

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

特性

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

安装依赖关系

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

pip3 install python-docx mcp

用法

在Cursor中用作MCP服务

  1. 打开光标并转到设置
  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许可证

相关 MCP