mcp-server-office

🚀 MCP 服务器办公（中文版）

这是一个模型上下文协议（MCP）服务器，主要提供微软 Word (docx) 文件的读写功能，能满足对 docx 文件的多种操作需求。

🚀 快速开始

安装

使用 pip 安装：

pip install mcp-server-office

启动服务

启动 MCP 服务器：

mcp-server-office

或者使用 uv 运行：

uvx mcp-server-office

📦 安装指南

系统要求

• Python >= 3.12
• 依赖：
  • mcp[cli] >= 1.2.0
  • python-docx >= 1.1.2

💻 使用示例

可用工具

1. read_docx

读取 docx 文件的完整内容，包括表格和图片。

• 输入：path（字符串）- 对应文件的绝对路径
• 注意：图片将转换为 [Image] 占位符，修订记录不会显示

2. write_docx

创建包含指定内容的新 docx 文件。

• 输入：
  • path（字符串）- 新文件的绝对路径
  • content（字符串）- 写入文件的内容
• 注意：使用双行换行符表示新段落，表格使用 [Table] 标签和 | 分隔符

3. edit_docx_paragraph

在 docx 文件的指定段落中进行文本替换。

• 输入：
  • path（字符串）- 要编辑的文件路径
  • edits（数组）- 包含搜索/替换信息和段落索引的字典列表
    • paragraph_index（数字）- 指定要修改的段落的 0 基数索引
    • search（字符串）- 在指定段落中查找的文本
    • replace（字符串）- 要替换的文本
• 注意：每个搜索字符串在指定段落内必须唯一匹配

4. edit_docx_insert

在 docx 文件中插入新的段落。

• 输入：
  • path（字符串）- 要编辑的文件路径
  • inserts（数组）- 包含要插入文本和可选段落索引的字典列表
    • text（字符串）- 作为新段落插入的文本
    • paragraph_index（数字，可选）- 插入位置的段落 0 基数索引。未指定则插入在末尾。