MCP Server Office

🚀 MCP サーバーオフィス（日本語版）

このモデルコンテキストプロトコル（MCP）サーバーは、Microsoft Word (docx) ファイルの読み書き機能を提供します。

🚀 クイックスタート

📦 インストール

pip を使用してインストールします：

pip install mcp-server-office

サーバーの起動

MCP サーバーを起動します：

mcp-server-office

または、uv を使用して実行します：

uvx mcp-server-office

💻 使用例

基本的な使用法

以下に、提供される各ツールの使用方法を示します。

利用可能なツール

1. read_docx：docx ファイルの全内容（表や画像を含む）を読み取ります。

   • 入力：path（文字列） - 対象ファイルの絶対パス
   • 注意：画像は [Image] プレースホルダーに変換され、修正履歴は表示されません。

2. write_docx：指定された内容を含む新しい docx ファイルを作成します。

   • 入力：
     • path（文字列） - 新しいファイルの絶対パス
     • content（文字列） - ファイルに書き込む内容
   • 注意：2 行の改行文字で新しい段落を表し、表は [Table] タグと | 区切り文字を使用します。

3. edit_docx_paragraph：docx ファイルの指定された段落内でテキストを置換します。

   • 入力：
     • path（文字列） - 編集するファイルのパス
     • edits（配列） - 検索/置換情報と段落インデックスを含む辞書のリスト
       • paragraph_index（数値） - 変更する段落の 0 から始まるインデックス
       • search（文字列） - 指定された段落内で検索するテキスト
       • replace（文字列） - 置換するテキスト
   • 注意：各検索文字列は指定された段落内で一意に一致する必要があります。

4. edit_docx_insert：docx ファイルに新しい段落を挿入します。

   • 入力：
     • path（文字列） - 編集するファイルのパス
     • inserts（配列） - 挿入するテキストとオプションの段落インデックスを含む辞書のリスト
       • text（文字列） - 新しい段落として挿入するテキスト
       • paragraph_index（数値、オプション） - 挿入位置の段落の 0 から始まるインデックス。指定されない場合は末尾に挿入されます。

🔧 技術詳細

システム要件

• Python >= 3.12
• 依存関係：
  • mcp[cli] >= 1.2.0
  • python-docx >= 1.1.2