PptMcp - Microsoft PowerPoint 用 MCP サーバー

AI で PowerPoint を自動化 — 対話型 AI による包括的な PowerPoint 自動化のための Model Context Protocol (MCP) サーバー。

PptMcp は、GitHub Copilot、Claude、ChatGPT などの AI アシスタントが自然言語コマンドで Microsoft PowerPoint を自動化できるようにします。スライドの作成、テキストの編集、図形や画像の配置、グラフや表の作成、テーマの適用、VBA の実行、PDF やビデオへの書き出し、ネイティブ COM API による PowerPoint ウィンドウの安全な管理まで、実際のプレゼンテーション作業をエンドツーエンドでカバーします。

由来とクレジット: このプロジェクトは、Stefan Broenner (sbroenne) が mcp-server-excel で作成したオリジナルの MCP 自動化基盤をベースに、PowerPoint に特化した完全なツールチェーンとして拡張したものです。

リリースとパッケージ: GitHub Releases | NuGet: PptMcp.McpServer | NuGet: PptMcp.CLI

ソースからの多段階のビルド / 検証 / 修復ワークフローには、リポジトリには公式オーケストレーションクライアントも src\PptMcp.Agent の下に含まれています。

🛡️ 100% 安全 — PowerPoint のネイティブ COM API を使用 — ファイル破損のリスクはゼロ。PowerPoint の公式 COM API を使用し、完全な安全性と互換性を保証します。

💡 対話型開発 — PowerPoint で結果を即座に確認できます。スライドの追加、グラフの作成、テキストの書式設定、反復作業が可能。PowerPoint が AI を活用したワークスペースになります。

技術要件:

• ⚠️ Windows のみ — COM 相互運用は Windows 固有です

• ⚠️ PowerPoint が必要 — Microsoft PowerPoint 2016 以降がインストールされている必要があります

• ⚠️ デスクトップ環境 — 実際の PowerPoint プロセスを制御します（サーバーサイド処理には非対応）

🎯 できること

223 の操作を備えた 33 の専門ツール:

• 📁 ファイル (1 ツール、6 操作) — プレゼンテーションの開く、閉じる、作成、保存、一覧表示、検証

• 📄 スライド (1 ツール、15 操作) — 作成、複製、移動、削除、レイアウト適用、非表示/再表示、サムネイル、置換付きクローン

• 🔷 図形 (1 ツール、35 操作) — 追加、移動、サイズ変更、塗りつぶし、グラデーション、線、影、グロー、反射、不透明度、3D、回転、Z オーダー、グループ化、コネクタ、結合、反転、拡大縮小

• ✏️ テキスト (1 ツール、18 操作) — テキストの取得/設定、検索、置換、書式設定、間隔、箇条書き、大文字小文字、記号、代替テキスト監査

• 📋 スライドテーブル (1 ツール、13 操作) — 作成、セルと行の読み書き、行と列の追加/削除、結合、書式設定、罫線

• 📊 グラフ (1 ツール、10 操作) — 作成、データ設定、タイトル、種類、凡例、軸タイトル、データテーブル

• 🖼️ 画像 (1 ツール、4 操作) — 挿入、トリミング、明るさ/コントラスト、透明色

• 🎥 メディア (1 ツール、4 操作) — オーディオ/ビデオの挿入、メディア情報、再生設定

• 🧩 SmartArt (1 ツール、6 操作) — ダイアグラム情報、ノードの追加/削除、レイアウト、スタイル、レベル変更

• 🎨 デザイン/テーマ (1 ツール、19 操作) — テーマ、配色、フォント、アーキタイプ、パレット、レイアウトグリッド、スタイルプロファイル

• 🖌️ スライド背景 (1 ツール、5 操作) — 取得、単色、グラデーション、画像、マスターにリセット

• 🎭 マスターとレイアウト (1 ツール、5 操作) — マスターとレイアウトの一覧表示、マスター図形の編集、未使用の削除

• 📌 プレースホルダー (1 ツール、3 操作) — プレースホルダーの一覧表示、テキスト設定、画像設定

• 📃 ヘッダーとフッター (1 ツール、2 操作) — フッターテキスト、スライド番号、日付の取得/設定

• 📐 ページ設定 (1 ツール、3 操作) — スライドサイズ、向き、最初のスライド番号

• ↔️ 図形の配置 (1 ツール、2 操作) — スライド上の図形の整列と分布

• 🎬 アニメーション (1 ツール、6 操作) — 一覧表示、追加、削除、クリア、タイミング、並べ替え

• 🔀 画面切り替え (1 ツール、4 操作) — 取得、設定、削除、全スライドにコピー

• 📺 スライドショー (1 ツール、5 操作) — 開始、停止、ナビゲート、ステータス、設定

• 🎞️ カスタム ショー (1 ツール、3 操作) — カスタム スライド ショーの作成、一覧表示、削除

• 📂 セクション (1 ツール、4 操作) — プレゼンテーションセクションの一覧表示、追加、名前変更、削除

• 📥 スライドのインポート (1 ツール、1 操作) — 別の .pptx ファイルからスライドをインポート

• 📝 ノート (1 ツール、5 操作) — すべての発表者ノートの取得、設定、クリア、追加、読み取り

• 💬 コメント (1 ツール、4 操作) — スライドコメントの追加、一覧表示、削除、クリア

• 🔗 ハイパーリンク (1 ツール、5 操作) — ハイパーリンクの追加、取得、一覧表示、削除、検証

• 🏷️ タグ (1 ツール、3 操作) — スライドと図形のカスタムメタデータ

• 🗂️ ドキュメントプロパティ (1 ツール、4 操作) — 組み込みおよびカスタムプロパティの取得/設定

• ♿ アクセシビリティ (1 ツール、3 操作) — 監査、読み上げ順序の取得/設定

• 🔤 校正 (1 ツール、3 操作) — スペルチェック、言語の取得/設定

• 📤 書き出し (1 ツール、9 操作) — PDF、スライド画像、ビデオ (MP4)、印刷、名前を付けて保存、テキスト/画像の抽出

• 🖨️ 印刷オプション (1 ツール、2 操作) — 印刷設定の取得/設定

• ⚙️ VBA (1 ツール、5 操作) — マクロの一覧表示、表示、インポート、削除、実行

• 🪟 ウィンドウ (1 ツール、7 操作) — 情報、最小化、復元、最大化、ズーム、表示モード

📚 完全な機能リファレンス → — 223 の全操作の詳細ドキュメント

Related MCP server: Office-PowerPoint-MCP

💬 プロンプトの例

プレゼンテーションの作成と構築:

• "QuarterlyReport.pptx というタイトルスライド付きの新しい PowerPoint プレゼンテーションを作成して"

• "「タイトルとコンテンツ」レイアウトでスライドを 5 枚追加して"

• "最初のスライドに会社のロゴ画像を挿入して"

コンテンツと書式設定:

• "スライド 2 に「Q1 Revenue Summary」というテキストを太字 24pt Arial でテキストボックスとして追加して"

• "スライド 3 に Region、Q1、Q2、Q3、Q4 の列を持つテーブルを作成して"

• "図形の塗りつぶし色を #0078D4 に設定し、2pt の枠線を追加して"

グラフとビジュアル:

• "スライド 4 に四半期の売上データを示す縦棒グラフを作成して"

• "グラフのタイトルを「Revenue by Quarter」に設定して"

• "グラフの図形に入場アニメーションを追加して"

自動化:

• "プレゼンテーションを PDF として書き出して"

• "FormatAllSlides マクロを実行して"

• "作業中は PowerPoint を見せて" — 変更をリアルタイムで確認

🪟 エージェントモード — AI が PowerPoint で作業する様子を見る:

• "このプレゼンテーションを作成している間、PowerPoint を並べて見せて" — リアルタイムの可視化

• "スライドを作成しているところを見せて"

• ステータスバーに進行状況がリアルタイム表示されます: "PptMcp: スライド 4 にグラフを作成中..."

👥 誰が使うべきか?

最適なユーザー:

• ✅ 反復的な PowerPoint ワークフローを自動化したいプレゼンター

• ✅ PowerPoint ベースのレポートソリューションを構築する開発者

• ✅ 複雑なプレゼンテーションデッキを管理するビジネスユーザー

• ✅ プレゼンテーションテンプレートと VBA マクロを管理するチーム

適さないケース:

• ❌ サーバーサイド処理（代わりに Open XML SDK などのライブラリを使用）

• ❌ Linux/macOS ユーザー（Windows + PowerPoint のインストールが必要）

• ❌ 大量のバッチ操作（PowerPoint を使わない代替手段を検討）

🚀 クイックスタート

⚠️ 重要: 使用前にすべての PowerPoint ファイルを閉じてください。サーバーは自動化中、プレゼンテーションへの排他アクセスを必要とします。

🔧 CLI と MCP サーバーの比較

このパッケージは CLI と MCP サーバー の両方のインターフェースを提供します。ユースケースに応じて選択してください:

手動インストール:

# Install MCP Server and CLI
dotnet tool install --global PptMcp.McpServer
dotnet tool install --global PptMcp.CLI

🤖 オプション: ソースからの公式エージェントクライアント

大規模なデッキ構築タスクには、このリポジトリには公式のソース側コントローラーも同梱されています: src\PptMcp.Agent。

これは意図的に第三のサーバーサーフェスではありません。代わりに MCP サーバーの上位に位置し、クライアント側のループを 1 つ実行します:

• デッキを計画

• 通常の順次 MCP ツール呼び出しで実行

• 生成されたデッキを検証

• 必要に応じて不完全な出力を修復

クイックスタート:

dotnet build src\PptMcp.McpServer\PptMcp.McpServer.csproj -c Release

Set-Location src\PptMcp.Agent
npm install
npm run check
npm test

node .\src\cli.mjs run `
  --task "Build a 5-slide executive deck on Q4 revenue performance and next actions." `
  --output "C:\Users\you\Documents\q4-revenue-deck.pptx"

詳細:

• エージェントクライアントコンポーネント README

• エージェントクライアントアーキテクチャ

• 評価フレームワーク

• アーキタイプパイプライン

⚙️ 仕組み — COM 自動化と統合サービスアーキテクチャ

PptMcp は Windows COM 自動化を使用して実際の PowerPoint アプリケーションを制御します（.pptx ファイルだけでなく）。

MCP サーバー と CLI の両方が、PowerPoint セッションを管理する共有の PptMcp サービス と通信します。この統合アーキテクチャにより、以下が可能になります:

┌─────────────────────┐     ┌─────────────────────┐
│   MCP Server        │     │   CLI (pptcli)    │
│  (AI assistants)    │     │  (coding agents)    │
└─────────┬───────────┘     └─────────┬───────────┘
          │                           │
          └──────────┬────────────────┘
                     ▼
          ┌─────────────────────────┐
          │   PptMcp Service      │
          │  (shared session mgmt)  │
          └─────────┬───────────────┘
                    ▼
          ┌─────────────────────────┐
          │   PowerPoint COM API    │
          │  (PowerPoint.Application)│
          └─────────────────────────┘

主な利点:

• ✅ 共有セッション — CLI と MCP サーバーが同じ開いているプレゼンテーションにアクセス可能

• ✅ 単一の PowerPoint インスタンス — 重複プロセスやファイルロックなし

• ✅ システムトレイ UI — PptMcp トレイアイコンからアクティブセッションを監視

💡 ヒント: AI が作業している間 PowerPoint を見る デフォルトでは、高速化のため PowerPoint は非表示で実行されます。変更をリアルタイムで確認するには、次のように依頼してください:

• "作業中は PowerPoint を見せて"

• "何をしているか見せて"

• "変更が見えるように PowerPoint を開いて"

AI が PowerPoint ウィンドウを表示し、すべての操作をライブで確認できます!

📋 追加情報

📚 CLI ガイド → | MCP サーバーガイド → | エージェントクライアント → | 評価フレームワーク → | アーキタイプパイプライン → | 全エージェントスキル →

ライセンス: MIT ライセンス - LICENSE ファイルを参照

貢献: ガイドラインは CONTRIBUTING.md を参照

開発環境: このプロジェクト全体は GitHub Copilot AI アシスタンスを使用して開発されました - 主に Claude、最近では Auto-mode を使用。

謝辞:

• Microsoft PowerPoint チーム — 包括的な COM 自動化 API を提供

• Model Context Protocol コミュニティ — AI 統合標準を提供

• オープンソースコミュニティ — インスピレーションとベストプラクティスを提供

関連プロジェクト

Stefan Broenner によるアップストリームプロジェクト:

• mcp-server-excel (アップストリーム) — Stefan Broenner による Excel 用のオリジナル MCP サーバー

• pytest-aitest — AI エージェント向け LLM 搭載テストフレームワーク