Word Document Formatter

🚀 Word MCP Server

Word MCP Serverは、APIを通じてMicrosoft Word文書（.docx）の作成と編集を可能にするPythonベースのアプリケーションです。このプロジェクトはFastMCPを使用して、Word文書と通信するためのインタラクティブなツールを構築しています。

🚀 クイックスタート

Word MCP Serverを使用することで、APIを通じてMicrosoft 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 .

📚 ドキュメント

大規模言語モデル（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("作成者： ")