Docxprocessor

🚀 Docx MCP サービス

English | 中文

FastMCP ライブラリに基づく Docx 文書処理サービスです。Cursor の AI アシスタントを通じて、Word 文書の作成、編集、管理をサポートします。

✨ 主な機能

• 完全な文書操作：文書の作成、開く、保存、および内容の追加、編集、削除をサポートします。
• 書式設定：フォント、色、サイズ、配置方法などの書式オプションの設定をサポートします。
• 表処理：表のセルの作成、編集、結合、分割をサポートします。
• 画像挿入：画像の挿入とサイズ設定をサポートします。
• レイアウト制御：ページ余白の設定、ページ区切りの追加、その他のレイアウト要素の設定をサポートします。
• 検索機能：文書情報、段落内容、表データの検索をサポートします。
• 便利な編集：検索と置換機能をサポートします。
• セクション編集：特定の部分の内容を置換し、元の書式とスタイルを保持することをサポートします。

📦 インストール

Python 3.10 以上がインストールされていることを確認し、以下の依存関係をインストールしてください。

pip3 install python-docx mcp

💻 使用例

Cursor で MCP サービスとして使用する場合

1. Cursor を開き、設定に移動します。
2. 機能 > MCP サーバー セクションに移動します。
3. 新しい MCP サーバーを追加 をクリックします。
4. 以下の情報を入力します。
   • 名前：MCP_DOCX
   • タイプ：コマンド
   • コマンド：python3 /path/to/MCP_dox/server.py（パスを実際の server.py のパスに置き換えてください）
5. 追加 をクリックしてサービスを追加します。

追加が完了したら、Cursor の AI アシスタントで自然言語を使用して Word 文書を操作できます。例えば：

• "新しい Word 文書を作成し、デスクトップに保存する"
• "3 レベルの見出しを追加する"
• "3x4 の表を挿入し、データを入力する"
• "2 番目の段落を太字にし、中央揃えにする"

📚 ドキュメント

サポートされる操作

このサービスは以下の操作をサポートしています。

• 文書管理：create_document, open_document, save_document
• 内容追加：add_paragraph, add_heading, add_table, add_picture
• 内容編集：edit_paragraph, delete_paragraph, delete_text
• 表操作：add_table_row, delete_table_row, edit_table_cell, merge_table_cells, split_table
• レイアウト制御：add_page_break, set_page_margins
• 検索機能：get_document_info, get_paragraphs, get_tables, search_text
• ファイル操作：create_document, open_document, save_document, save_as_document, create_document_copy
• セクション編集：replace_content_in_section（元の書式とスタイルを保持）
• その他：set_header_and_footer, add_watermark

動作原理

このサービスは Python-docx を使用して Word 文書を処理し、FastMCP ライブラリを通じて AI アシスタントと通信します。ユーザーの命令を解析し、対応する文書操作を実行し、結果を返します。

排版能力

• テキスト階層：見出し、本文などの異なる階層のテキストを処理することをサポートします。
• ページレイアウト：ヘッダー、フッター、透かし、セクション区切りの設定をサポートします。
• フォントスタイル：フォント、文字サイズ、色、配置方法の調整をサポートします。
• 表書式：表の余白、行の高さ、列の幅の調整をサポートします。
• ページ区切り制御：ページ区切りの追加と奇数ページの処理をサポートします。

開発上の注意事項

• server.py は核心実装ファイルで、ユーザーの命令を解析し、文書処理ロジックとやり取りします。
• より高度なニーズに対応するための拡張をサポートします。
• 一般的な問題を解決するためのトラブルシューティング手順を提供します。

トラブルシューティング

1. 正しい Python バージョン（3.10 以上）がインストールされていることを確認してください。
2. 依存関係が正しくインストールされていることを確認してください。
3. パス設定が正しいことを確認してください。
4. コンソール出力を確認して、詳細な情報を取得してください。

📄 ライセンス

このサービスは MIT License を採用しており、自由な使用と修正が許可されています。

このドキュメントでは、Docx MCP サービスの機能、インストール手順、使用方法、開発上の注意事項が全面的に紹介されています。Cursor で Word 文書処理機能を統合したいユーザーにとって、非常に価値のあるリソースとなっています。