PptMcp – MCP-Server für Microsoft PowerPoint

Automatisieren Sie PowerPoint mit KI – Ein Model Context Protocol (MCP)-Server für umfassende PowerPoint-Automatisierung durch konversationelle KI.

PptMcp ermöglicht KI-Assistenten wie GitHub Copilot, Claude und ChatGPT, Microsoft PowerPoint über natürliche Sprachbefehle zu automatisieren. Es deckt die gesamte Präsentationsarbeit ab: Folien erstellen, Text bearbeiten, Formen und Bilder platzieren, Diagramme und Tabellen erstellen, Designs anwenden, VBA ausführen, als PDF oder Video exportieren und Live-PowerPoint-Fenster sicher über die native COM-API verwalten.

Ursprung und Anerkennung: Dieses Projekt basiert auf der ursprünglichen MCP-Automatisierungsgrundlage von Stefan Broenner (sbroenne) in mcp-server-excel, die hier zu einer vollständigen PowerPoint-orientierten Toolchain erweitert wurde.

Releases und Pakete: GitHub Releases | NuGet: PptMcp.McpServer | NuGet: PptMcp.CLI

Für mehrstufige Build-/Verifizierungs-/Reparatur-Workflows aus dem Quellcode enthält das Repository auch den offiziellen Orchestrierungs-Client unter src\PptMcp.Agent.

🛡️ 100 % sicher – Verwendet die native COM-API von PowerPoint – Kein Risiko von Dateibeschädigung. Verwendet die offizielle COM-API von PowerPoint für vollständige Sicherheit und Kompatibilität.

💡 Interaktive Entwicklung – Ergebnisse sofort in PowerPoint sehen. Folien hinzufügen, Diagramme erstellen, Text formatieren und iterieren. PowerPoint wird zu Ihrem KI-gestützten Arbeitsbereich.

Technische Anforderungen:

• ⚠️ Nur Windows – COM-Interop ist Windows-spezifisch

• ⚠️ PowerPoint erforderlich – Microsoft PowerPoint 2016 oder höher muss installiert sein

• ⚠️ Desktop-Umgebung – Steuert den tatsächlichen PowerPoint-Prozess (nicht für serverseitige Verarbeitung)

🎯 Was Sie tun können

33 spezialisierte Tools mit 223 Operationen:

• 📁 Dateien (1 Tool, 6 Operationen) – Öffnen, schließen, erstellen, speichern, auflisten, Präsentationen validieren

• 📄 Folien (1 Tool, 15 Operationen) – Erstellen, duplizieren, verschieben, löschen, Layouts anwenden, ein-/ausblenden, Miniaturen, Klonen mit Ersetzen

• 🔷 Formen (1 Tool, 35 Operationen) – Hinzufügen, verschieben, Größe ändern, Füllung, Verlauf, Linie, Schatten, Glühen, Spiegelung, Deckkraft, 3D, Drehung, Z-Reihenfolge, Gruppierung, Verbinder, Zusammenführen, spiegeln, skalieren

• ✏️ Text (1 Tool, 18 Operationen) – Text abrufen/festlegen, suchen, ersetzen, formatieren, Abstände, Aufzählungszeichen, Groß-/Kleinschreibung, Symbole, Alt-Text-Prüfung

• 📋 Folientabellen (1 Tool, 13 Operationen) – Erstellen, Zellen und Zeilen lesen/schreiben, Zeilen und Spalten hinzufügen/löschen, zusammenführen, formatieren, Rahmen

• 📊 Diagramme (1 Tool, 10 Operationen) – Erstellen, Daten festlegen, Titel, Typ, Legende, Achsentitel, Datentabelle

• 🖼️ Bilder (1 Tool, 4 Operationen) – Einfügen, zuschneiden, Helligkeit/Kontrast, transparente Farbe

• 🎥 Medien (1 Tool, 4 Operationen) – Audio/Video einfügen, Medieninformationen, Wiedergabeeinstellungen

• 🧩 SmartArt (1 Tool, 6 Operationen) – Diagramminformationen, Knoten hinzufügen/löschen, Layout, Stil, Ebenenänderungen

• 🎨 Design/Themes (1 Tool, 19 Operationen) – Designs, Farbschemata, Schriftarten, Archetypen, Paletten, Layoutraster, Stilprofile

• 🖌️ Folienhintergrund (1 Tool, 5 Operationen) – Abrufen, Volltonfarbe, Verlauf, Bild, auf Master zurücksetzen

• 🎭 Master & Layouts (1 Tool, 5 Operationen) – Master und Layouts auflisten, Masterformen bearbeiten, ungenutzte löschen

• 📌 Platzhalter (1 Tool, 3 Operationen) – Platzhalter auflisten, Text festlegen, Bild festlegen

• 📃 Kopf- und Fußzeilen (1 Tool, 2 Operationen) – Fußzeilentext, Foliennummern, Datum abrufen/festlegen

• 📐 Seiteneinrichtung (1 Tool, 3 Operationen) – Foliengröße, Ausrichtung, erste Foliennummer

• ↔️ Formausrichtung (1 Tool, 2 Operationen) – Formen auf Folien ausrichten und verteilen

• 🎬 Animationen (1 Tool, 6 Operationen) – Auflisten, hinzufügen, entfernen, löschen, Timing, neu anordnen

• 🔀 Übergänge (1 Tool, 4 Operationen) – Abrufen, festlegen, entfernen, auf alle Folien kopieren

• 📺 Bildschirmpräsentation (1 Tool, 5 Operationen) – Starten, stoppen, navigieren, Status, konfigurieren

• 🎞️ Benutzerdefinierte Shows (1 Tool, 3 Operationen) – Benutzerdefinierte Folienpräsentationen erstellen, auflisten, löschen

• 📂 Abschnitte (1 Tool, 4 Operationen) – Abschnitte der Präsentation auflisten, hinzufügen, umbenennen, löschen

• 📥 Folienimport (1 Tool, 1 Operation) – Folien aus einer anderen .pptx-Datei importieren

• 📝 Notizen (1 Tool, 5 Operationen) – Abrufen, festlegen, löschen, anhängen, alle Sprechernotizen lesen

• 💬 Kommentare (1 Tool, 4 Operationen) – Hinzufügen, auflisten, löschen, Folienkommentare entfernen

• 🔗 Hyperlinks (1 Tool, 5 Operationen) – Hinzufügen, abrufen, auflisten, entfernen, Hyperlinks validieren

• 🏷️ Tags (1 Tool, 3 Operationen) – Benutzerdefinierte Metadaten auf Folien und Formen

• 🗂️ Dokumenteigenschaften (1 Tool, 4 Operationen) – Integrierte und benutzerdefinierte Eigenschaften abrufen/festlegen

• ♿ Barrierefreiheit (1 Tool, 3 Operationen) – Prüfung, Lesereihenfolge abrufen/festlegen

• 🔤 Korrektur (1 Tool, 3 Operationen) – Rechtschreibprüfung, Sprache abrufen/festlegen

• 📤 Export (1 Tool, 9 Operationen) – PDF, Folienbilder, Video (MP4), Drucken, Speichern unter, Text/Bilder extrahieren

• 🖨️ Druckoptionen (1 Tool, 2 Operationen) – Druckkonfiguration abrufen/festlegen

• ⚙️ VBA (1 Tool, 5 Operationen) – Makros auflisten, anzeigen, importieren, löschen, ausführen

• 🪟 Fenster (1 Tool, 7 Operationen) – Informationen, minimieren, wiederherstellen, maximieren, Zoom, Ansichtsmodus

📚 Vollständige Funktionsreferenz → – Detaillierte Dokumentation aller 223 Operationen

Related MCP server: Office-PowerPoint-MCP

💬 Beispiel-Prompts

Präsentationen erstellen und aufbauen:

• "Erstellen Sie eine neue PowerPoint-Präsentation mit dem Namen QuarterlyReport.pptx mit einer Titelfolie"

• "Fügen Sie 5 Folien mit einem Layout 'Titel und Inhalt' hinzu"

• "Fügen Sie ein Firmenlogo-Bild auf der ersten Folie ein"

Inhalt und Formatierung:

• "Fügen Sie auf Folie 2 ein Textfeld mit dem Text 'Q1 Revenue Summary' in fettem 24pt Arial hinzu"

• "Erstellen Sie auf Folie 3 eine Tabelle mit Spalten für Region, Q1, Q2, Q3, Q4"

• "Setzen Sie die Füllfarbe der Form auf #0078D4 und fügen Sie einen 2pt-Rahmen hinzu"

Diagramme und Visualisierungen:

• "Erstellen Sie auf Folie 4 ein Balkendiagramm mit vierteljährlichen Umsatzdaten"

• "Setzen Sie den Diagrammtitel auf 'Revenue by Quarter'"

• "Fügen Sie der Diagrammform eine Eingangsanimation hinzu"

Automatisierung:

• "Exportieren Sie die Präsentation als PDF"

• "Führen Sie das Makro FormatAllSlides aus"

• "Zeigen Sie mir PowerPoint, während Sie arbeiten" – Änderungen in Echtzeit beobachten

🪟 Agentenmodus – KI bei der Arbeit in PowerPoint beobachten:

• "Zeigen Sie mir PowerPoint nebeneinander, während Sie diese Präsentation erstellen" – Echtzeit-Sichtbarkeit

• "Lassen Sie mich zusehen, während Sie die Folien erstellen"

• Statusleiste zeigt Live-Fortschritt: "PptMcp: Erstelle Diagramm auf Folie 4..."

👥 Wer sollte dies verwenden?

Perfekt für:

• ✅ Präsentierende, die repetitive PowerPoint-Workflows automatisieren

• ✅ Entwickler, die PowerPoint-basierte Berichtslösungen erstellen

• ✅ Geschäftsanwender, die komplexe Präsentationssammlungen verwalten

• ✅ Teams, die Präsentationsvorlagen und VBA-Makros pflegen

Nicht geeignet für:

• ❌ Serverseitige Verarbeitung (verwenden Sie stattdessen Bibliotheken wie Open XML SDK)

• ❌ Linux/macOS-Benutzer (Windows + PowerPoint-Installation erforderlich)

• ❌ Massenstapeloperationen (erwägen Sie PowerPoint-freie Alternativen)

🚀 Schnellstart

⚠️ Wichtig: Schließen Sie alle PowerPoint-Dateien vor der Verwendung. Der Server benötigt während der Automatisierung exklusiven Zugriff auf Präsentationen.

🔧 CLI vs. MCP-Server

Dieses Paket bietet sowohl CLI- als auch MCP-Server-Schnittstellen. Wählen Sie je nach Anwendungsfall:

Manuelle Installation:

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

🤖 Optional: Offizieller Agent-Client aus dem Quellcode

Für größere Deck-Erstellungsaufgaben enthält dieses Repository auch einen offiziellen quellseitigen Controller: src\PptMcp.Agent.

Es ist bewusst keine dritte Serveroberfläche. Stattdessen sitzt es über dem MCP-Server und führt eine clientseitige Schleife aus:

• den Deck planen

• über normale sequenzielle MCP-Tool-Aufrufe ausführen

• den generierten Deck verifizieren

• unvollständige Ausgabe bei Bedarf reparieren

Schnellstart:

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"

Weiterlesen:

• Agent Client Component README

• Agent Client Architecture

• Eval Framework

• Archetype Pipeline

⚙️ So funktioniert es – COM-Automatisierung und einheitliche Service-Architektur

PptMcp verwendet Windows-COM-Automatisierung, um die tatsächliche PowerPoint-Anwendung zu steuern (nicht nur .pptx-Dateien).

Sowohl der MCP-Server als auch die CLI kommunizieren mit einem gemeinsamen PptMcp-Dienst, der PowerPoint-Sitzungen verwaltet. Diese einheitliche Architektur ermöglicht:

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

Hauptvorteile:

• ✅ Gemeinsame Sitzungen – CLI und MCP-Server können auf dieselben geöffneten Präsentationen zugreifen

• ✅ Einzelne PowerPoint-Instanz – Keine doppelten Prozesse oder Dateisperren

• ✅ System-Tray-Benutzeroberfläche – Aktive Sitzungen über das PptMcp-Tray-Symbol überwachen

💡 Tipp: PowerPoint beobachten, während die KI arbeitet Standardmäßig läuft PowerPoint ausgeblendet für schnellere Automatisierung. Um Änderungen in Echtzeit zu sehen, fragen Sie einfach:

• "Zeigen Sie mir PowerPoint, während Sie arbeiten"

• "Lassen Sie mich sehen, was Sie tun"

• "Öffnen Sie PowerPoint, damit ich die Änderungen sehen kann"

Die KI zeigt das PowerPoint-Fenster an, sodass Sie jede Operation live mitverfolgen können!

📋 Zusätzliche Informationen

📚 CLI-Anleitung → | MCP-Server-Anleitung → | Agent-Client → | Eval-Framework → | Archetyp-Pipeline → | Alle Agent-Fähigkeiten →

Lizenz: MIT-Lizenz – siehe LICENSE-Datei

Mitwirken: Siehe CONTRIBUTING.md für Richtlinien

Erstellt mit: Dieses gesamte Projekt wurde mit GitHub Copilot KI-Unterstützung entwickelt – hauptsächlich mit Claude, aber in letzter Zeit mit Auto-Modus.

Danksagungen:

• Microsoft PowerPoint-Team – Für umfassende COM-Automatisierungs-APIs

• Model Context Protocol-Community – Für den KI-Integrationsstandard

• Open-Source-Community – Für Inspiration und bewährte Praktiken

Verwandte Projekte

Upstream-Projekte von Stefan Broenner:

• mcp-server-excel (upstream) – Original-MCP-Server für Excel von Stefan Broenner

• pytest-aitest – LLM-gestütztes Testframework für KI-Agenten