Office Word

🚀 オフィス Word-MCP サーバー

このサーバーは、Model Context Protocol (MCP) を実装し、Microsoft Word 文書の作成、読み取り、操作を可能にします。Claude for Desktop やその他の MCP クライアントと組み合わせることで、文書の自動化処理が可能です。

🚀 クイックスタート

このサーバーは、Model Context Protocol (MCP) をベースに開発され、Microsoft Word 文書の自動化処理をサポートします。Claude for Desktop やその他の MCP クライアントと連携することで、文書の作成、編集、保存などの操作を自動化できます。

✨ 主な機能

• 文書管理：Word 文書の作成、読み取り、操作を行います。
• 内容作成：見出し、段落、表、画像を追加できます。
• テキスト整形：フォントのスタイル、サイズ、色などを調整します。
• 表整形：表の枠線、背景、その他の属性を設定します。

💻 使用例

基本的な使用法

以下は、サーバーの機能を使用したコード例です。

# 添加标题
add_heading("example.docx", "这是一个标题", level=1)

# 添加段落
add_paragraph("example.docx", "这是第一段文字。")

# 添加表格
add_table("example.docx", 2, 2)

# 调整文本样式
format_text("example.docx", 0, 0, 5, bold=True, color="FF0000")

📚 ドキュメント

文書管理

• create_document：新しい文書を作成します。
• open_document：既存の文書を開きます。
• save_document：文書を保存します。
• close_document：文書を閉じます。

内容作成

• add_heading：見出しを追加します。
• add_paragraph：段落を追加します。
• add_table：表を追加します。
• add_picture：画像を挿入します。
• add_page_break：改ページを挿入します。

テキスト整形

• format_text：テキストのスタイル（太字、斜体、色など）を調整します。
• search_and_replace：テキストを検索して置換します。
• delete_paragraph：段落を削除します。

表整形

• format_table：表の枠線、背景、その他の属性を設定します。

📦 インストール

システム要件

• オペレーティングシステム：Windows、Linux、または macOS。
• Python バージョン：3.6 以上。

インストール手順

1. プロジェクトのリポジトリをクローンします。

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

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

   pip install python-docx fastmcp
   

📚 ドキュメント

Claude for Desktop の設定

1. settings.json ファイルを開きます。
2. 以下の設定を追加します。

   {
     "mcp_server": "file:///path/to/server.py"
   }
   

3. サーバーを起動し、Claude に接続します。

📚 ドキュメント

API ドキュメント

文書管理インターフェース

• create_document(path: str) -> None：指定されたパスに新しい文書を作成します。
• open_document(path: str) -> None：既存の文書を開きます。
• save_document() -> None：現在の文書を保存します。

内容作成インターフェース

• add_heading(text: str, level: int = 1) -> None：指定されたテキストとレベルで見出しを追加します。

🔧 技術詳細

よくある問題と解決策

スタイルが欠落している場合

• 一部の文書では、必要なスタイルが欠落していることがあります。
• サーバーは、欠落しているスタイルを作成しようとし、または直接整形を適用します。

権限の問題

• サーバーがファイルパスに対して読み書き権限を持っていることを確認してください。
• copy_document を使用して、編集可能なコピーを作成します。

🤝 貢献ガイド

Pull Request の提出を歓迎します！

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. リモートリポジトリにプッシュします。
5. プルリクエストを提出します。

📄 ライセンス

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

⚠️ 重要提示

このサーバーは文書ファイルとやり取りするため、Claude for Desktop などの MCP クライアントで確認する前に、適切な操作を行ってください。