Office-Word-MCP-サーバー
Microsoft Word文書の作成、読み取り、操作のためのモデルコンテキ��トプロトコル（MCP）サーバー。このサーバーにより、AIアシスタントは標準化されたインターフェースを介してWord文書を操作でき、豊富なドキュメント編集機能を提供します。
概要
Office-Word-MCP-Serverは、モデルコンテキストプロトコルを実装し、Word文書の操作をツールおよびリソースとして公開します。AIアシスタントとMicrosoft Word文書間の橋渡しとして機能し、文書の作成、コンテンツの追加、書式設定、分析を可能にします。
サーバーは、コア機能、ツール、ユーティリティに関心を分離するモジュール式アーキテクチャを採用しており、将来の機能強化に備えて保守性と拡張性が非常に高くなっています。
例
突然
出力
特徴
ドキュメント管理
- メタデータを含む新しい Word 文書を作成する
- テキストを抽出し、文書構造を分析する
- ドキュメントのプロ��ティと統計情報を表示する
- ディレクトリ内の利用可能なドキュメントを一覧表示する
- 既存のドキュメントのコピーを作成する
- 複数の文書を1つの文書に結合する
- Word文書をPDF形式に変換する
コンテンツ作成
- 異なるレベルの見出しを追加する
- オプションのスタイルで段落を挿入する
- カスタムデータでテーブルを作成する
- 比例スケーリングで画像を追加する
- 改ページを挿入する
- 文書に脚注と文末脚注を追加する
- 脚注を文末脚注に変換する
- 脚注と文末脚注のスタイルをカスタマイズする
リッチテキストフォーマット
- 特定のテキストセクションの書式設定（太字、斜体、下線）
- テキストの色とフォントのプロパティを変更する
- テキスト要素にカスタムスタイルを適用する
- 文書全体のテキストの検索と置換
表の書式設定
- 境界線とスタイルで表をフォーマットする
- 異なる書式のヘッダー行を作成する
- セルの網掛けとカスタム境界線を適用する
- 読みやすさを向上させるための表の構造化
高度なドキュメント操作
- 段落を削除する
- カスタムドキュメントスタイルを作成する
- ドキュメント全体で一貫した書式を適用する
- 詳細な制御で特定の範囲のテキストをフォーマットする
文書保護
- ドキュメントにパスワード保護を追加する
- 編集可能なセクションで制限された編集を実装する
- 文書にデジタル署名を追加する
- 文書の真正性と完全性を検証する
インストール
前提条件
- 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構成の生成
Claude for Desktop での使用
構成
方法1: ローカルインストール後
- インストール後、Claude for Desktop 構成ファイルにサーバーを追加します。
{
"mcpServers": {
"word-document-server": {
"command": "python",
"args": ["/path/to/word_mcp_server.py"]
}
}
}
方法2: インストールなし（uvxを使用）
- uvx パッケージ マネージャーを使用して、ローカル インストールなしでサーバーを使用するように Claude for Desktop を構成することもできます。
{
"mcpServers": {
"word-document-server": {
"command": "uvx",
"args": ["--from", "office-word-mcp-server", "word_mcp_server"]
}
}
}
- 構成ファイルの場所:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- 構成をロードするには、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)
convert_to_pdf(filename, output_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)
コンテンツ抽出
get_document_text(filename)
get_paragraph_text_from_document(filename, paragraph_index)
find_text_in_document(filename, text_to_find, match_case=True, whole_word=False)
テキストの書式設定
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)
トラブルシューティング
よくある問題
- スタイルが見つからない
- 一部の文書では、見出しや表の操作に必要なスタイルが不足している場合があります。
- サーバーは不足しているスタイルを作成するか、直接書式設定を使用します。
- 最良の結果を得るには、標準のWordスタイルのテンプレートを使用してください。
- 権限の問題
- サーバーにドキュメントパスの読み取り/書き込み権限があることを確認する
- ロックされたドキュメントの編集可能なコピーを作成するには、
copy_document関数を使用します。 - 操作が失敗した場合はファイルの所有権と権限を確認してください
- 画像挿入の問題
- 画像ファイルには絶対パスを使用する
- 画像形式の互換性を確認する（JPEG、PNG を推奨）
- 画像ファイルのサイズと権限を確認する
デバッグ
環境変数を設定して詳細なログ記録を有効にします。
export MCP_DEBUG=1 # Linux/macOS
set MCP_DEBUG=1 # Windows
貢献
貢献を歓迎します！お気軽にプルリクエストを送信してください。
- リポジトリをフォークする
- 機能ブランチを作成します（
git checkout -b feature/amazing-feature ） - 変更をコミットします (
git commit -m 'Add some amazing feature' ) - ブランチにプッシュする (
git push origin feature/amazing-feature ) - プルリクエストを開く
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。
謝辞
注: このサーバーはシステム上のドキュメントファイルとやり取りします。Claude for Desktop やその他の MCP クライアントで確認する前に、要求された操作が適切であることを必ず確認してください。