# MCP-Doc 文档处理工具
## 基本信息
- Slug: `meterlong-mcp-doc`
- Source: modelscope
- Publisher: @MeterLong/MCP-Doc
- Categories: file-systems / developer-tools
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@MeterLong/MCP-Doc
## 简介
基于 FastMCP 的强大 Word 文档处理服务，使 AI 助手能够创建、编辑和管理带有完整格式支持的 docx 文件。在编辑内容时保留原始样式。
## 安装提示

```bash
pip3 install python-docx mcp
```

## MCP Server 详情

# Docx MCP 服务

[English](README.md) | [中文](README_ZH.md)

[![smithery badge](https://smithery.ai/badge/@MeterLong/mcp-doc)](https://smithery.ai/server/@MeterLong/mcp-doc)

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

## 特性

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

## 安装依赖

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

```bash
pip3 install python-docx mcp
```


## 使用方法

### 作为 MCP 服务在 Cursor 中使用

1. 打开 Cursor 并进入设置
2. 找到 `Features > MCP Servers` 部分
3. 点击 `Add new MCP server`
4. 填写以下信息：
   - 名称：MCP_DOCX
   - 类型：Command
   - 命令：`python3 /path/to/MCP_dox/server.py`（请替换为实际的 `server.py` 路径）
5. 点击 `Add` 添加服务

添加后，您可以在 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`, `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 许可证