Word Document Formatter

🚀 Word MCP Server

Word MCP Server 是一個基於 Python 的應用程序，它允許通過 API 創建和編輯 Microsoft Word 文檔（.docx）。該項目藉助 FastMCP 構建交互式工具，實現與 Word 文檔的通信。

🚀 快速開始

要使用 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 文檔。
• 根據提示自動生成內容。
• 智能格式化文本、插入圖片和表格。

✨ 主要特性

Word MCP Server 提供以下功能：

1. 創建和打開 Word 文檔。
2. 添加和格式化文本。
3. 插入圖片。
4. 創建表格。
5. 管理資源和提示。

📦 安裝指南

要求

• Python 3.12+
• 依賴庫：
  • python-docx
  • opencv-python (cv2)
  • numpy
  • FastMCP

安裝庫

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

💻 使用示例

基礎用法

創建新文檔

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("創建者： ")