Powerpoint Presentations

🚀 PPTX MCP サーバ

FastMCP をベースにしたサーバで、プログラムによる PowerPoint (PPTX) プレゼンテーションの作成、編集、レンダリングが可能です。スライドの作成、テキストと形状の挿入、画像の埋め込み、およびスライドの PNG へのレンダリング（LibreOffice を使用）をサポートしています。

✨ 主な機能

• プレゼンテーションの作成/クリア：新しい PPTX ファイルを開始するか、既存のものをリセットします。
• スライドの追加：カスタムレイアウトを持つスライドを挿入します。
• テキストとコンテンツ：スライドにタイトル、コンテンツ、およびカスタムテキストボックスを追加します。
• 形状：様々な PowerPoint 形状（フローチャート要素を含む）を挿入します。
• 画像：画像をスライドに埋め込みます。
• スライドの説明：スライドの内容のテキスト要約を取得して検証します。
• スライドのレンダリング：スライドを PNG 画像にレンダリングします（LibreOffice が必要）。
• PPTX のダウンロード：生成されたプレゼンテーションファイルをダウンロードします。

📦 インストール

必要条件

• Python 3.12+
• python-pptx
• Pillow
• FastMCP
• 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 からダウンロード

💻 使用例

基本的な使用法

サーバを起動します：

python server.py

サーバのホストとポートは環境変数で設定できます：

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

例えば、すべてのインターフェースで 9000 ポートを使用して実行するには：

HOST=0.0.0.0 PORT=9000 python server.py

または（開発環境の FastMCP 用）：

fastmcp dev server.py

📚 ドキュメント

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/ に追加することができます。