Office PowerPoint

🚀 オフィス - PowerPoint モデルコンテキストプロトコル（MCP）サーバ

このサーバは、Python-pptxを使用してPowerPointプレゼンテーションを作成および操作するためのモデルコンテキストプロトコル（MCP）サーバです。PPTファイルに対して、作成、編集、保存、情報取得などの様々な操作を行うためのツールを提供します。

🚀 クイックスタート

以下の手順に従って、サーバをセットアップしてください。

📦 インストール

セットアップスクリプトを使用したインストール

1. このリポジトリをクローンします：

git clone https://github.com/your-username/ppt-mcp-server.git
cd ppt-mcp-server

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

pip install python-pptx requests

3. サーバを起動します：

python server.py

📚 ドキュメント

サーバ設定

• サーバ名: ppt
• リッスンアドレス: 0.0.0.0
• ポート番号: 5000

リクエスト形式

すべてのリクエストには、以下の共通パラメータが必要です：

✨ 主な機能

ドキュメントツール

• create_presentation: 新しいプレゼンテーションを作成します。
• get_presentation_info: 現在のプレゼンテーションの情報を取得します。
• set_core_properties: ドキュメントのコア属性を設定します。

スライドツール

• add_slide: プレゼンテーションに新しいスライドを追加します。
• get_slide_info: 特定のスライドの情報を取得します。
• populate_placeholder: スライド内のプレースホルダーに内容を入力します。
• add_bullet_points: プレースホルダーに項目記号リストを追加します。

テキストツール

• add_textbox: スライド上にテキストボックスを追加します。

画像ツール

• add_image: スライドに画像を追加します。
• add_image_from_base64: Base64文字列から画像をスライドに追加します。

テーブルツール

• add_table: スライドにテーブルを追加します。
• format_table_cell: テーブル内のセルをフォーマットします。

形状ツール

• add_shape: スライドに自作図形を追加します。

グラフツール

• add_chart: スライドにグラフを追加します。

💻 使用例

基本的な使用法

新しいプレゼンテーションの作成

# 新しいプレゼンテーションを作成
result = use_mcp_tool(
    server_name="ppt",
    tool_name="create_presentation",
    arguments={}
)
presentation_id = result["presentation_id"]

# タイトルスライドを追加
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_slide",
    arguments={
        "layout_index": 0,  # タイトルスライドのレイアウトインデックス
        "title": "私のプレゼンテーション",
        "presentation_id": presentation_id
    }
)
slide_index = result["slide_index"]

# サブタイトルのプレースホルダーを埋める
result = use_mcp_tool(
    server_name="ppt",
    tool_name="populate_placeholder",
    arguments={
        "slide_index": slide_index,
        "placeholder_idx": 1,  # サブタイトルのプレースホルダーインデックス
        "text": "PowerPoint MCPサーバを使用して作成",
        "presentation_id": presentation_id
    }
)

# プレゼンテーションを保存
result = use_mcp_tool(
    server_name="ppt",
    tool_name="save_presentation",
    arguments={
        "file_path": "私のプレゼンテーション.pptx",
        "presentation_id": presentation_id
    }
)

高度な使用法

グラフの追加

# 内容スライドを追加
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_slide", 
    arguments={
        "layout_index": 1,  # 内容スライドのレイアウトインデックス
        "title": "販売データ",
        "presentation_id": presentation_id
    }
)
slide_index = result["slide_index"]

# 棒グラフを追加
result = use_mcp_tool(
    server_name="ppt", 
    tool_name="add_chart", 
    arguments={
        "slide_index": slide_index,
        "chart_type": "column",
        "left": 1.0,
        "top": 2.0,
        "width": 8.0, 
        "height": 4.5,
        "categories": ["Q1", "Q2", "Q3", "Q4"],
        "series": [
            {
                "name": "販売額",
                "values": [10, 20, 15, 25]
            }
        ],
        "title": "四半期販売データ",
        "x_axis_title": "四半期",
        "y_axis_title": "金額（万円）",
        "presentation_id": presentation_id
    }
)

📄 ライセンス

このプロジェクトはMITライセンスを使用しています。詳細なライセンス内容はLICENSEファイルを参照してください。

📞 連絡先

何か質問や提案がある場合は、以下の連絡先までご連絡ください：

• メールアドレス: your.email@example.com
• GitHub: あなたのGitHubリンク

⚠️ 重要提示

上記のコード例は実際の使用シナリオに基づいて作成されていますが、具体的な実装はバージョンの違いにより異なる場合があります。