Word MCP Server

Word MCP Server

Word MCP Server は、API を通じて Microsoft Word（.docx）文書を作成・編集できる Python アプリケーションです。このプロジェクトでは、FastMCP を使用して 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")

見出しと段落の追加

# 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

注意事項

• このプロジェクトでは、Word 文書を操作するために python-docx ライブラリを使用します
• リソースとプロンプトは、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")