Word Document Formatter

🚀 Word MCP Server

Word MCP Server 是一个基于 Python 的应用程序，允许通过 API 创建和编辑 Microsoft Word 文档 (.docx)。该项目使用 FastMCP 构建交互式工具以与 Word 文档进行通信，为用户提供便捷的 Word 文档处理方案。

🚀 快速开始

📦 安装指南

要求

• Python 3.12+
• 依赖库：
  • python-docx
  • opencv-python (cv2)
  • numpy
  • FastMCP

安装库

uv venv
source venv/bin/activate
uv pip install .

✨ 主要特性

Word MCP Server 提供以下功能：

1. 创建和打开 Word 文档
2. 添加和格式化文本
3. 插入图片
4. 创建表格
5. 管理资源和提示

💻 使用示例

配置与启动 LLM

要使用 Word MCP Server 与大语言模型 (LLM)，需要通过 JSON 文件进行配置：

{
  "mcpServers": {
    "word-mcp-server": {
      "command": "/path/to/word-mcp-server/.venv/bin/python3",
      "args": ["/path/to/word-mcp-server/server.py"]
    }
  }
}

配置解释：

• mcpServers：包含各个 MCP 服务器的配置对象
• word-mcp-server：服务器的标识名
• command：Python 解释器路径（通常在虚拟环境中）
• args：命令行参数，其中第一个参数是 server.py 的路径

启动后，服务器将准备好接收来自 LLM 的指令

与 LLM 交互：

成功配置并启动后，您可以使用 LLM 进行：

• 自然语言创建和编辑 Word 文档
• 根据提示自动生成内容
• 智能格式化文本、插入图片和表格

基础用法

创建新文档

create_new_document()

打开现有文档

open_document("path/to/document.docx")

添加标题和段落

# 添加标题
add_heading("文档标题", level=0)
add_heading("章节 1", level=1)

# 添加段落文本
add_paragraph("这是正文内容。")

# 添加带格式的段落
add_paragraph(
    "这是带格式的正文。",
    style="Normal",
    font_size=14,
    bold=True,
    italic=False,
    alignment=WD_PARAGRAPH_ALIGNMENT.CENTER
)

添加文本格式

# 创建基本段落
p = add_paragraph("这是基本正文。 ")

# 添加具有不同格式的部分
add_run_to_paragraph(
    p,
    " 这部分加粗并显示红色。",
    bold=True,
    color="red"
)

# 添加带高亮的部分
add_run_to_paragraph(
    p,
    " 这部分带有黄色高亮。",
    highlight="yellow"
)

插入图片

# 从文件路径插入图片
add_picture("path/to/image.jpg", width=4.0)

# 或从 numpy 数组插入图片
import numpy as np
import cv2

# 示例：创建一个简单的图像数组
image_array = np.zeros((100, 100, 3), dtype=np.uint8)
image_array[:, :, 0] = 255  # 红色
add_picture_from_array(image_array)  # 假设有一个名为 add_picture_from_array 的函数

# 或从文件路径插入图片
add_picture("project_diagram.jpg", width=5.0)

创建表格

# 添加标题行
add_paragraph("项目数据：")
add_heading("项目数据", level=2)
table = add_table(rows=3, cols=3)

# 填充表格内容
table.cell(0, 0).text = "数据1"
table.cell(0, 1).text = "数据2"
table.cell(0, 2).text = "数据3"
# 继续填充其他单元格...

完整示例

# 创建新文档
create_new_document()

# 添加标题
add_heading("项目报告", level=0)

# 添加创建者信息
p = add_paragraph("创建者： ")