PPTX MCP Server

PPTX MCP サーバー

FastMCP を搭載した、PowerPoint (PPTX) プレゼンテーションをプログラムで作成、編集、レンダリングできるサーバーです。スライドの作成、テキストと図形の挿入、画像の埋め込み、PNG へのスライドレンダリング (LibreOffice を使用) をサポートします。

特徴

• **プレゼンテーションの作成/クリア:**新しい PPTX ファイルを開始するか、既存の PPTX ファイルをリセットします。
• **スライドの追加:**カスタマイズ可能なレイアウトでスライドを挿入します。
• **テキストとコンテンツ:**スライドにタイトル、コンテンツ、カスタム テキスト ボックスを追加します。
• **図形:**さまざまな PowerPoint 図形 (フローチャート要素を含む) を挿入します。
• **画像:**スライドに画像を埋め込みます。
• **スライドの説明:**検証のためにスライドの内容のテキスト要約を取得します。
• **スライドのレンダリング:**スライドを PNG 画像としてレンダリングします (LibreOffice が必要です)。
• **PPTX をダウンロード:**生成されたプレゼンテーション ファイルをダウンロードします。

要件

• Python 3.12以上
• Python-pptx
• 枕
• ファストMCP
• LibreOffice (スライド画像のレンダリング用。別途インストールし、システム PATH で利用可能にする必要があります)

インストール

1. Python の依存関係をインストールします。
   pip install -r requirements.txt
   （依存関係についてはpyproject.toml参照してください）
2. LibreOffice をインストールします(画像レンダリング用):
   • Linux: sudo pacman -S libreoffice-freshまたはsudo apt install libreoffice
   • macOS: brew install --cask libreoffice
   • Windows: libreoffice.orgからダウンロード

使用法

サーバーを起動します。

環境変数を使用してサーバーのホストとポートを設定できます。

• HOST （デフォルト： 127.0.0.1 ）
• PORT （デフォルト： 8000 ）

たとえば、すべてのインターフェースとポート 9000 で実行するには、次のようにします。

または (FastMCP を使用した開発の場合):

APIの概要

サーバーは、FastMCP を介して次のようなツールとリソースを公開します。

• create_or_clear_presentation(filename)
• add_slide(filename, layout_index)
• add_title_and_content(filename, slide_index, title, content)
• add_textbox(filename, slide_index, text, left_inches, top_inches, width_inches, height_inches, font_size_pt, bold)
• add_shape(filename, slide_index, shape_type_name, left_inches, top_inches, width_inches, height_inches, text)
• add_picture(filename, slide_index, image, left_inches, top_inches, width_inches, height_inches)
• get_slide_content_description(filename, slide_index)
• get_slide_image(filename, slide_index)(LibreOfficeが必要)
• get_pptx_file(filename)

完全なパラメータの詳細と使用可能なシェイプ タイプについては、コードを参照してください。

プレゼンテーションとテンプレート

• プレゼンテーションはpresentations/ディレクトリに保存されます。
• presentations/templates/に独自のテンプレートを追加できます。

ライセンス

詳細についてはライセンスを参照してください。