Word MCP Server

Word MCP 服务

Word MCP 服务是一个 Python 应用，可通过 API 创建和编辑 Microsoft Word（.docx）文档。此项目使用 FastMCP 构建与 Word 文档交互的工具。

安装

要求

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

安装库

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

功能

Word MCP 服务提供以下工具：

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

使用指南

配置并与大模型一起启动

若要将 Word MCP 服务与大语言模型（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 文件的路径

服务将启动并准备好接收来自大模型的命令

与大模型交互：

配置并成功启动后，你可以使用大模型来：

• 通过自然语言命令创建和编辑 Word 文档
• 根据提示词自动生成内容
• 智能地设置文本格式、添加图像和表格

创建新文档

create_new_document()

打开现有文档

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

添加标题和段落

# Thêm tiêu đề
add_heading("Tiêu đề tài liệu", level=0)
add_heading("Chương 1", level=1)

# Thêm đoạn văn bản
add_paragraph("Đây là nội dung đoạn văn bản.")

# Thêm đoạn văn bản với định dạng
add_paragraph(
    "Đây là đoạn văn bản được định dạng.",
    style="Normal",
    font_size=14,
    bold=True,
    italic=False,
    alignment=WD_PARAGRAPH_ALIGNMENT.CENTER
)

为部分文本设置格式

# Tạo đoạn văn bản
p = add_paragraph("Đây là đoạn văn bản cơ bản. ")

# Thêm phần văn bản có định dạng khác
add_run_to_paragraph(
    p,
    "Phần này được in đậm và màu đỏ.",
    bold=True,
    color="red"
)

# Thêm phần văn bản có highlight
add_run_to_paragraph(
    p,
    " Phần này được highlight màu vàng.",
    highlight="yellow"
)

添加图像

# Thêm hình ảnh từ đường dẫn file
add_picture("path/to/image.jpg", width=4.0)

# Hoặc thêm hình ảnh từ ma trận numpy
import numpy as np
import cv2

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

创建表格

# Tạo bảng với 3 hàng và 4 cột
table = add_table(rows=3, cols=4, style="Table Grid")

# Điền dữ liệu vào bảng
table.cell(0, 0).text = "Hàng 1, Cột 1"
table.cell(0, 1).text = "Hàng 1, Cột 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 文件夹中
• 运行服务前，请确保已安装所有依赖库

完整示例

# Tạo tài liệu mới
create_new_document()

# Thêm tiêu đề
add_heading("Báo cáo dự án", level=0)

# Thêm thông tin người tạo
p = add_paragraph("Người tạo: ")
add_run_to_paragraph(p, "Nguyễn Văn A", bold=True)

# Thêm mục lục
add_heading("Mục lục", level=1)
add_paragraph("1. Giới thiệu")
add_paragraph("2. Nội dung")
add_paragraph("3. Kết luận")

# Thêm nội dung
add_heading("1. Giới thiệu", level=1)
add_paragraph("Đây là phần giới thiệu của dự án...")

# Thêm hình ảnh
add_paragraph("Hình ảnh minh họa:")
add_picture("project_diagram.jpg", width=5.0)

# Thêm bảng dữ liệu
add_heading("Bảng dữ liệu", level=2)
table = add_table(rows=3, cols=3)
table.cell(0, 0).text = "Dữ liệu 1"
table.cell(0, 1).text = "Dữ liệu 2"
table.cell(0, 2).text = "Dữ liệu 3"
# Điền các dữ liệu khác...

# Lưu tài liệu
save_document("bao_cao_du_an.docx")