Office Word MCP Server

🚀 オフィス Word MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を利用して、Microsoft Word 文書の作成、読み取り、操作を行うためのものです。AI アシスタントが標準化されたインターフェースを通じて Word 文書とやり取りできるようにし、豊富な文書編集機能を提供します。

🚀 クイックスタート

このサーバーは、モデルコンテキストプロトコル（MCP）に基づいており、Microsoft Word 文書とのやり取りを可能にします。文書の操作（タイトル、段落、表、画像の追加など）や、テキストと表の書式設定をサポートしています。

✨ 主な機能

• 文書操作：Word 文書の作成、読み取り、修正が可能です。
• 内容追加：タイトル、段落、表、画像の追加をサポートしています。
• テキスト書式設定：太字、斜体、下線、文字色、フォントサイズなどの設定が可能です。
• 表書式設定：表の見出し行、枠線スタイル、セルの背景色の設定をサポートしています。

📦 インストール

環境要件

インストール手順

1. リポジトリをクローンします：

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. 依存関係をインストールします：

   pip install python-docx fastmcp
   

3. サーバーを起動します：

   export MCP_SERVER=office-word-mcp-server  # Linux/macOS
   set MCP_SERVER=office-word-mcp-server     # Windows
   python server.py
   

💻 使用例

基本的な使用法

文書パスの設定

1. 文書の保存パスを設定します：
   • config.json ファイルを編集して、document_storage_path を指定します。

   {
     "document_storage_path": "/path/to/storage"
   }
   

2. テンプレートをアップロードします：
   • Word テンプレートファイルを templates ディレクトリに配置します。

タイトルの追加

add_heading("example.docx", "これはタイトルです", level=1)

段落の追加

add_paragraph("example.docx", "これは段落です。")

表の追加

add_table("example.docx", rows=2, cols=3)

高度な使用法

API リファレンス

文書操作

• 新しい文書の作成：

  create_document(filename)
  

• 既存の文書を開く：

  open_document(filename)
  

内容追加

• タイトルの追加：

  add_heading(filename, text, level=1)
  

• 段落の追加：

  add_paragraph(filename, text, style=None)
  

テキスト書式設定

• テキストのスタイルを設定する：

  format_text(filename, paragraph_index, start_pos, end_pos, bold=None,
              italic=None, underline=None, color=None, font_size=None, font_name=None)
  

🔧 トラブルシューティング

一般的な問題

• スタイルが不足している場合：Word テンプレートを使用して、必要なすべてのスタイルが利用可能か確認してください。
• 権限の問題：サーバーが文書ファイルを読み書きできる権限を持っていることを確認してください。
• 画像の挿入に失敗した場合：絶対パスを使用し、画像の形式とサイズを確認してください。

デバッグ

詳細なログを有効にするには：

export MCP_DEBUG=1  # Linux/macOS
set MCP_DEBUG=1     # Windows

🤝 コントリビューションガイド

コントリビューションを歓迎します！以下の手順に従ってください：

1. リポジトリを Fork します。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. リモートリポジトリにプッシュします。
5. Pull Request を送信します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。

🙏 謝辞

• モデルコンテキストプロトコル（MCP）はプロトコルの仕様を提供しています。
• python-docx ライブラリは Word 文書の操作に使用されています。
• FastMCP は Python MCP の実装をサポートしています。

⚠️ 重要注意

このサーバーはシステム内の文書ファイルとやり取りします。MCP クライアント（Claude for Desktop など）が要求する操作を確認する前に、常にその適切性を検証してください。