PPT MCP Server

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

このプロジェクトは、モデル制御プロトコル（MCP）を通じて、Claude Desktop と連携する PowerPoint 自動化サーバーを提供します。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. 内容を追加します：

   在幻灯片1上添加一个包含文本 "Hello World" 的文本框。
   

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 をいつでも送信してください。

📄 ライセンス

MIT License