Word MCP Server

Word MCP Server 是一个 Python 应用程序，它允许通过 API 创建和编辑 Microsoft Word (.docx) 文档。该项目使用 FastMCP 来构建与 Word 文档交互的工具。

安装

依赖

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

安装库

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

功能

Word MCP Server 提供了以下工具：

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

使用指南

配置并使用 LLM 启动

要将 Word MCP Server 与大型语言模型（LLM）一起使用，您需要通过 JSON 文件进行配置：

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 文档
• 根据提示自动生成内容
• 智能地格式化文本、添加图片和表格

创建新文档

python create_new_document()

打开现有文档

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

添加标题和段落

python

添加标题

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 )

为部分文本添加格式

python

创建段落文本

p = add_paragraph("这是基本的段落文本。 ")

添加具有不同格式的部分文本

add_run_to_paragraph( p, "这部分加粗且为红色。", bold=True, color="red" )

添加高亮部分文本

add_run_to_paragraph( p, " 这部分被黄色高亮。", highlight="yellow" )

添加图片

python

从文件路径添加图片

add_picture("path/to/image.jpg", width=4.0)

或者从 numpy 数组添加图片

import numpy as np import cv2

img = cv2.imread("path/to/image.jpg") add_picture(img, width=3.5)

创建表格

python

创建一个 3 行 4 列的表格

table = add_table(rows=3, cols=4, style="Table Grid")

填充表格数据

table.cell(0, 0).text = "第1行, 第1列" table.cell(0, 1).text = "第1行, 第2列"

...

支持的颜色

在使用 color 和 highlight 参数时，您可以使用以下值：

• black
• blue
• green
• dark blue
• dark red
• dark yellow
• dark green
• pink
• red
• white
• teal
• yellow
• violet
• gray25
• gray50

注意事项

• 该项目使用 python-docx 库来与 Word 文档进行交互
• 资源和提示存储在 resources 和 prompts 目录中- 确保在运行服务器之前已经安装了所有依赖库

完整示例

python

创建新文档

create_new_document()

添加标题

add_heading("项目报告", level=0)

添加创建者信息

p = add_paragraph("创建者: ") add_run_to_paragraph(p, "阮文A", bold=True)

添加目录

add_heading("目录", level=1) add_paragraph("1. 介绍") add_paragraph("2. 内容") add_paragraph("3. 结论")

添加内容

add_heading("1. 介绍", level=1) add_paragraph("这是项目的介绍部分...")

添加图片

add_paragraph("插图:") add_picture("project_diagram.jpg", width=5.0)

添加数据表

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"

填充其他数据...

保存文档

save_document("bao_cao_du_an.docx")

请注意，上述代码中的函数名和变量名保持英文不变，以确保与原始代码的一致性和可读性。此外，“阮文A”是“Nguyễn Văn A”的中文翻译，根据上下文可能需要调整为更合适的译名或保留原名。