Docx MCP サービス

英語|中国語

FastMCP ライブラリに基づく Docx ドキュメント処理サービス。Cursor の AI アシスタントを使用して Word ドキュメントの作成、編集、管理をサポートします。

特徴

• 完全なドキュメント操作: ドキュメントの作成、開く、保存、コンテンツの追加、編集、削除をサポート
• 書式設定: フォント、色、サイズ、配置、その他の書式設定オプションの設定をサポート
• 表処理: 表セルの作成、編集、結合、分割をサポート
• 画像挿入: 画像の挿入とサイズの設定をサポート
• レイアウトコントロール: ページ余白の設定、ページ区切りの追加、その他のレイアウト要素のサポート
• クエリ関数: 文書情報、段落コンテンツ、表データの取得をサポート
• 便利な編集:検索と置換機能のサポート
• セクション編集: 元の書式とスタイルを維持しながら、特定のセクションのコンテンツを置き換える機能をサポート

インストールの依存関係

Python 3.10 以降がインストールされていることを確認してから、次の依存関係をインストールします。

使用法

カーソルでMCPサービスとして使用する

1. カーソルを開いて設定へ移動します
2. Features > MCP Serversセクションを見つけます
3. Add new MCP serverクリックします
4. 次の情報を入力してください。
   • 名前: MCP_DOCX
   • タイプ: コマンド
   • コマンド: python3 /path/to/MCP_dox/server.py ( server.pyへの実際のパスに置き換えてください)
5. サービスを追加するにはAddをクリックします

追加すると、カーソルの 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_section 、 edit_section_by_keyword
• その他の機能: find_and_replace 、 search_and_replace （プレビュー機能付き）

仕組み

1. このサービスはPython-docxライブラリを使用してWord文書を処理します。
2. AIアシスタントと通信するためにFastMCPライブラリを通じてMCPプロトコルを実装します。
3. リクエストを処理し、フォーマットされたレスポンスを返す
4. 完全なエラー処理とステータスレポートをサポートします

タイポグラフィ機能

このサービスには優れたタイポグラフィ理解機能があります。

• テキスト階層: 見出しレベル(1～9)と段落構成のサポート
• ページレイアウト: ページ余白設定のサポート
• 視覚要素: フォントスタイル（太字、斜体、下線、色）と配置のサポート
• 表レイアウト: 表の作成、セルの結合、表の分割、表形式の設定をサポート
• ページネーション制御: ページ区切りの追加をサポート

開発ノート

• server.py - FastMCP ライブラリを使用した MCP サービスのコア実装

トラブルシューティング

カーソルで問題が発生した場合は、次の手順を試してください。

1. Python 3.10以降が正しくインストールされていることを確認する
2. python-docx および mcp ライブラリが正しくインストールされていることを確認します。
3. サーバーパスが正しいか確認してください
4. カーソルアプリケーションを再起動します

注記

• python-docx および mcp ライブラリが正しくインストールされていることを確認します。
• パス内の中国語文字が正しく処理されることを確認する
• 絶対パスを使用するとパス解析の問題を回避できます

ライセンス

MITライセンス