Powerpoint Automation

🚀 PowerPoint 自動化 MCP サーバー for Claude Desktop

このプロジェクトは、Claude Desktop と連携して使用する PowerPoint 自動化サーバーを提供します。Model Control Protocol (MCP) を通じて相互作用を実現し、Claude が Microsoft PowerPoint を制御し、プレゼンテーションの作成、スライドの追加、内容の修正などのタスクを実行できるようにします。

✨ 主な機能

• PowerPoint プレゼンテーションの作成、開く、保存、閉じる
• すべての開いているプレゼンテーションを一覧表示
• スライドの情報と内容を取得
• さまざまなレイアウトの新しいスライドを追加
• スライドにテキストボックスを追加
• 形状内のテキスト内容を更新
• スライドのタイトルを設定
• その他、多くの機能！

📦 インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   uv add fastmcp pywin32
   

3. Claude Desktop を設定します。
   • Claude Desktop を開きます。
   • 設定に移動します。
   • 以下の説明に従って MCP サーバーを設定します。

🛠️ 設定

Claude Desktop をこの MCP サーバーを使用するように設定するには、%APPDATA%\Claude\claude_desktop_config.json に以下の内容を追加します。

{
  "mcpServers": {
    "ppts": {
      "command": "uv",
      "args": ["run", "path/to/main.py"]
    }
  }
}

仮想環境または他の Python 実行ファイル（例：uv）を使用している場合：

{
  "mcpServers": {
    "ppts": {
      "command": "C:\\Path\\To\\Python\\Scripts\\uv.exe",
      "args": ["run", "C:\\Path\\To\\Project\\main.py"]
    }
  }
}

💻 使用例

基本的な使用法

設定が完了したら、Claude Desktop を使用して PowerPoint を制御できます。以下はサンプルの対話例です。

1. PowerPoint を初期化します。

   私のために PowerPoint を開いてくれますか？
   

2. 新しいプレゼンテーションを作成します。

   新しい PowerPoint プレゼンテーションを作成してください。
   

3. スライドを追加します。

   プレゼンテーションに新しいスライドを追加してください。
   

4. 内容を追加します。

   最初のページのスライドに「こんにちは、世界」という内容のテキストボックスを追加してください。
   

5. プレゼンテーションを保存します。

   プレゼンテーションを C:\Users\username\Documents\presentation.pptx に保存してください。
   

📚 ドキュメント

サーバーは以下の PowerPoint 自動化機能を提供します。

• initialize_powerpoint(): PowerPoint に接続して表示します。
• get_presentations(): すべての開いているプレゼンテーションを一覧表示します。
• open_presentation(path): プレゼンテーションファイルを開きます。
• get_slides(presentation_id): プレゼンテーション内のすべてのスライドを取得します。
• get_slide_text(presentation_id, slide_id): スライドのテキスト内容を取得します。
• update_text(presentation_id, slide_id, shape_id, text): 形状内のテキストを更新します。
• save_presentation(presentation_id, path): プレゼンテーションを保存します。
• close_presentation(presentation_id, save): プレゼンテーションを閉じます。
• create_presentation(): 新しいプレゼンテーションを作成します。
• add_slide(presentation_id, layout_type): 新しいスライドを追加します。
• add_text_box(presentation_id, slide_id, text, left, top, width, height): テキストボックスを追加します。
• set_slide_title(presentation_id, slide_id, title): スライドのタイトルを設定します。

📋 要件

• Microsoft PowerPoint がインストールされた Windows システム
• Python 3.7 以上
• Claude Desktop クライアント
• pywin32 と fastmcp Python パッケージ

⚠️ 制限事項

• PowerPoint がインストールされた Windows でのみ動作します。
• 操作中は PowerPoint アプリケーションが開いて表示されます。
• PowerPoint COM API で公開されている機能に限定されます。

🤝 貢献

貢献を歓迎します！いつでも Pull Request を送信してください。

📄 ライセンス

（ここに具体的なライセンス情報を記載する必要があります）