Office Word MCP Server

by GongRzhe
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Office-Word-MCP-サーバー

Microsoft Word文書の作成、読み取り、操作のためのモデルコンテキストプロトコル(MCP)サーバー。このサーバーにより、AIアシスタントは標準化されたインターフェースを介してWord文書を操作でき、豊富なドキュメント編集機能を提供します。

概要

Office-Word-MCP-Serverは、モデルコンテキストプロトコルを実装し、Word文書の操作をツールおよびリソースとして公開します。AIアシスタントとMicrosoft Word文書間の橋渡しとして機能し、文書の作成、コンテンツの追加、書式設定、分析を可能にします。

ポンプト

出力

特徴

ドキュメント管理

  • メタデータを含む新しい Word 文書を作成する
  • テキストを抽出し、文書構造を分析する
  • ドキュメントのプロパティと統計情報を表示する
  • ディレクトリ内の利用可能なドキュメントを一覧表示する
  • 既存のドキュメントのコピーを作成する

コンテンツ作成

  • 異なるレベルの見出しを追加する
  • オプションのスタイルで段落を挿入する
  • カスタムデータでテーブルを作成する
  • 比例スケーリングで画像を追加する
  • 改ページを挿入する

リッチテキストフォーマット

  • 特定のテキストセクションの書式設定(太字、斜体、下線)
  • テキストの色とフォントのプロパティを変更する
  • テキスト要素にカスタムスタイルを適用する
  • 文書全体のテキストの検索と置換

表の書式設定

  • 境界線とスタイルで表をフォーマットする
  • 異なる書式のヘッダー行を作成する
  • セルの網掛けとカスタム境界線を適用する
  • 読みやすさを向上させるための表の構造化

高度なドキュメント操作

  • 段落を削除する
  • カスタムドキュメントスタイルを作成する
  • ドキュメント全体で一貫した書式を適用する
  • 詳細な制御で特定の範囲のテキストをフォーマットする

インストール

前提条件

  • Python 3.8以上
  • pip パッケージマネージャー

基本的なインストール

# Clone the repository git clone https://github.com/GongRzhe/Office-Word-MCP-Server.git cd Office-Word-MCP-Server # Install dependencies pip install -r requirements.txt

セットアップスクリプトの使用

あるいは、次の処理を実行する提供されているセットアップ スクリプトを使用することもできます。

  • 前提条件の確認
  • 仮想環境の設定
  • 依存関係のインストール
  • MCP構成の生成
python setup_mcp.py

Claude for Desktop での使用

構成

方法1: ローカルインストール後

  1. インストール後、Claude for Desktop 構成ファイルにサーバーを追加します。
{ "mcpServers": { "word-document-server": { "command": "python", "args": [ "/path/to/word_server.py" ] } } }

方法2: インストールなし(uvxを使用)

  1. uvx パッケージ マネージャーを使用して、ローカル インストールなしでサーバーを使用するように Claude for Desktop を構成することもできます。
{ "mcpServers": { "word-document-server": { "command": "uvx", "args": [ "--from", "office-word-mcp-server", "word_mcp_server" ] } } }
  1. 構成ファイルの場所:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. 構成をロードするには、Claude for Desktop を再起動します。

操作例

設定が完了すると、Claude に次のような操作の実行を依頼できるようになります。

  • 「タイトルページ付きの「report.docx」という新しいドキュメントを作成します」
  • 「文書に見出しと3つの段落を追加する」
  • 「売上データを含む4x4のテーブルを挿入する」
  • 「第2段落の「重要」という単語を太字と赤色で表示します」
  • 「「古い用語」のすべてのインスタンスを検索して「新しい用語」に置き換えます」
  • 「セクション見出しのカスタムスタイルを作成する」
  • 「文書内の表に書式を適用する」

APIリファレンス

ドキュメントの作成とプロパティ

create_document(filename, title=None, author=None) get_document_info(filename) get_document_text(filename) get_document_outline(filename) list_available_documents(directory=".") copy_document(source_filename, destination_filename=None)

コンテンツの追加

add_heading(filename, text, level=1) add_paragraph(filename, text, style=None) add_table(filename, rows, cols, data=None) add_picture(filename, image_path, width=None) add_page_break(filename)

テキストの書式設定

format_text(filename, paragraph_index, start_pos, end_pos, bold=None, italic=None, underline=None, color=None, font_size=None, font_name=None) search_and_replace(filename, find_text, replace_text) delete_paragraph(filename, paragraph_index) create_custom_style(filename, style_name, bold=None, italic=None, font_size=None, font_name=None, color=None, base_style=None)

表の書式設定

format_table(filename, table_index, has_header_row=None, border_style=None, shading=None)

トラブルシューティング

よくある問題

  1. スタイルが見つかりません
    • 一部の文書では、見出しや表の操作に必要なスタイルが不足している場合があります。
    • サーバーは不足しているスタイルを作成するか、直接書式設定を使用します。
    • 最良の結果を得るには、標準のWordスタイルのテンプレートを使用してください。
  2. 権限の問題
    • サーバーにドキュメントパスの読み取り/書き込み権限があることを確認する
    • ロックされたドキュメントの編集可能なコピーを作成するには、 copy_document関数を使用します。
    • 操作が失敗した場合はファイルの所有権と権限を確認してください
  3. 画像挿入の問題
    • 画像ファイルには絶対パスを使用する
    • 画像形式の互換性を確認する(JPEG、PNG を推奨)
    • 画像ファイルのサイズと権限を確認する

デバッグ

環境変数を設定して詳細なログ記録を有効にします。

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

貢献

貢献を歓迎します!お気軽にプルリクエストを送信してください。

  1. リポジトリをフォークする
  2. 機能ブランチを作成します( git checkout -b feature/amazing-feature
  3. 変更をコミットします ( git commit -m 'Add some amazing feature' )
  4. ブランチにプッシュする ( git push origin feature/amazing-feature )
  5. プルリクエストを開く

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

謝辞


注: このサーバーはシステム上のドキュメントファイルとやり取りします。Claude for Desktop やその他の MCP クライアントで確認する前に、要求された操作が適切であることを必ず確認してください。

ID: llldhr59w2