MCP Server Office
2025.03.22
7
Python文件管理文件管理
MCP Server Office 是一个基于 Model Context Protocol (MCP) 的服务，专门用于读取和写入 Microsoft Word (docx) 文件。它提供了多种工具来操作 docx 文件，包括读取文件内容、创建新文件、编辑段落文本以及插入新段落等功能。
View on GitHub
Overview
基本能力
产品定位
MCP Server Office 是一个专门用于操作 Microsoft Word (docx) 文件的 MCP 服务，提供了一系列工具来读取、写入和编辑 docx 文件。
核心功能
- 读取 docx 文件：
read_docx工具可以读取 docx 文件的完整内容，包括表格和图片（图片会被转换为 [Image] 占位符）。 - 写入 docx 文件：
write_docx工具可以创建新的 docx 文件，并支持写入文本内容（段落用双换行分隔，表格用 [Table] 标签和 | 分隔符表示）。 - 编辑段落文本：
edit_docx_paragraph工具可以替换指定段落中的文本内容。 - 插入新段落：
edit_docx_insert工具可以在指定位置或文件末尾插入新的段落。
适用场景
- 自动化文档处理：批量读取或生成 docx 文件。
- 文档内容编辑：对现有 docx 文件进行文本替换或段落插入。
- 数据导出：将结构化数据（如表格）导出为 docx 格式。
工具列表
read_docx：读取 docx 文件内容。- 输入：文件路径（绝对路径）。
- 输出：文件内容（包括表格和图片占位符）。
write_docx：创建新的 docx 文件。- 输入：文件路径和内容（支持段落和表格格式）。
edit_docx_paragraph：编辑指定段落中的文本。- 输入：文件路径和编辑指令（搜索/替换文本及段落索引）。
edit_docx_insert：在文件中插入新段落。- 输入：文件路径和插入指令（文本内容和可选段落索引）。
常见问题解答
- 图片处理：图片会被转换为 [Image] 占位符，无法直接显示。
- 段落索引：段落索引从 0 开始，必须确保搜索文本在指定段落中唯一匹配。
- 表格格式：表格需用 [Table] 标签和 | 分隔符表示。
使用教程
使用依赖
- 确保已安装 Python 3.12 或更高版本。
- 安装依赖包：
bash pip install mcp[cli]>=1.2.0 python-docx>=1.1.2
安装教程
- 使用 pip 安装服务：
bash pip install mcp-server-office - 启动服务：
bash mcp-server-office或使用 uv：bash uvx mcp-server-office
调试方式
- 确保服务已启动并运行。
- 使用工具命令测试功能，例如：
bash mcp-server-office read_docx path/to/file.docx检查输出是否符合预期。