🚀 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 提供以下功能：
- 创建和打开 Word 文档
- 添加和格式化文本
- 插入图片
- 创建表格
- 管理资源和提示
💻 使用示例
配置与启动 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("创建者： ")