PowerPoint Automation MCP Server for Claude Desktop

Claude Desktop 向け PowerPoint 自動化 MCP サーバー

このプロジェクトは、Model Control Protocol（MCP）を介して Claude Desktop と連携する PowerPoint 自動化サーバーを提供します。Claude が Microsoft PowerPoint を操作できるようになり、プレゼンテーションの作成、スライドの追加、コンテンツの変更などを実行できます。

機能

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

クイックスタート

1. uvx を使用して実行します。

uvx --from https://github.com/socamalo/PPT_MCP_Server.git mcp-ppt

インストール

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

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

   uv add fastmcp pywin32
   

3. Claude Desktop を設定します。

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

設定

Claude Desktop でこの MCP サーバーを使用するには、%APPDATA%\Claude\claude_desktop_config.json にある Claude Desktop の設定ファイルに、以下を追加します。

{
  "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 を初期化します。

   Could you open PowerPoint for me?
   

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

   Please create a new PowerPoint presentation.
   

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

   Add a new slide to the presentation.
   

4. コンテンツを追加します。

   Add a text box to slide 1 with the text "Hello World".
   

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

   Save the presentation to 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 クライアント
• Python パッケージの pywin32 と fastmcp

制限事項

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

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

MIT ライセンス