mcp-word-processor

このプロジェクトは、Model Context Protocol (MCP) に準拠したWord文書処理サーバーです。 pywin32 ライブラリを使用してMicrosoft Wordアプリケーションを直接操作することで、 Wordファイル（.docx）内のテキストコンテンツの抽出と置換を行います。 python-docx ライブラリは使用していません。

機能

• Wordファイルのテキストコンテンツ全体（本文、ヘッダー、フッター、表、図形内のテキストなど）を抽出します。

• Wordファイル内の指定されたテキストを別のテキストに置換し、新しいファイルとして保存します。

• Windows環境でのみ動作します。

セットアップ

1. 仮想環境の作成と依存関係のインストール

プロジェクトルートディレクトリで、uv を使用して仮想環境を作成し、必要な依存関係をインストールします。

uv venv
# 仮想環境をアクティベート (Windows PowerShellの場合)
.venv\Scripts\Activate.ps1
# 依存関係のインストール
uv pip install mcp pywin32 fastapi uvicorn

pyproject.toml に依存関係が定義されているため、uv pip install の代わりに uv pip sync を使用することもできます。

2. サンプルWordファイルの準備

templates ディレクトリを作成し、テスト用のWordファイル (sample_template.docx) を配置してください。

mkdir templates

例: templates/sample_template.docx

This is a sample Word document.

Here is some text to be replaced: {{OLD_TEXT_1}}
And another one: {{OLD_TEXT_2}}

This is a table:
+-------+-------+
| Header1 | Header2 |
+-------+-------+
| Value1  | Value2  |
+-------+-------+

In the header: Document Title
In the footer: Page Number

サーバーの実行

プロジェクトのルートディレクトリから main.py を実行することでサーバーを起動できます。

python main.py

サーバーは標準入出力を介してMCPリクエストを待ち受けます。

利用可能なツール

このMCPサーバーは以下のツールを提供します。

get_word_elements

指定されたWordファイルから全てのテキスト要素を取得します。

• 説明: Word文書の本文、ヘッダー、フッター、表、図形内のテキストなど、全ての可視テキストを抽出します。

• 入力スキーマ:

  {
      "type": "object",
      "properties": {
          "file_path": {
              "type": "string",
              "description": "処理するWordファイルの絶対パス。"
          }
      },
      "required": ["file_path"]
  }

• 例:

  {
      "name": "get_word_elements",
      "arguments": {
          "file_path": "C:\\path\\to\\your\\document.docx"
      }
  }

replace_word_elements

指定されたWordファイル内のテキストを指定された内容で置換し、新しいファイルに保存します。

• 説明: 元のWordファイルをコピーし、そのコピー内で複数のテキスト置換を実行し、指定されたパスに新しいファイルとして保存します。

• 入力スキーマ:

  {
      "type": "object",
      "properties": {
          "file_path": {
              "type": "string",
              "description": "処理するWordファイルの絶対パス。"
          },
          "output_path": {
              "type": "string",
              "description": "変更を保存する新しいWordファイルの絶対パス。"
          },
          "replacements": {
              "type": "object",
              "patternProperties": {
                  "^[a-zA-Z0-9_\\s\\S]+$": {
                      "type": "string"
                  }
              },
              "description": "置換するキー（古いテキスト）と値（新しいテキスト）のペアを含む辞書。"
          }
      },
      "required": ["file_path", "output_path", "replacements"]
  }

• 例:

  {
      "name": "replace_word_elements",
      "arguments": {
          "file_path": "C:\\path\\to\\your\\templates\\sample_template.docx",
          "output_path": "C:\\path\\to\\your\\output\\new_document.docx",
          "replacements": {
              "{{OLD_TEXT_1}}": "新しいテキスト1",
              "{{OLD_TEXT_2}}": "新しいテキスト2",
              "Header1": "新しいヘッダー1"
          }
      }
  }

注意事項

• このサーバーはWindows環境にMicrosoft Wordがインストールされている必要があります。

• pywin32 を使用しているため、サーバー実行中はバックグラウンドでWordアプリケーションが起動します。

• output_path には、元の file_path と異なるパスを指定してください。同じパスを指定すると予期せぬ動作を引き起こす可能性があります。