PptMcp - Servidor MCP para Microsoft PowerPoint

Automatiza PowerPoint con IA: un servidor Model Context Protocol (MCP) para la automatización integral de PowerPoint mediante IA conversacional.

PptMcp permite a asistentes de IA como GitHub Copilot, Claude y ChatGPT automatizar Microsoft PowerPoint mediante comandos en lenguaje natural. Cubre el trabajo real de presentaciones de principio a fin: crear diapositivas, editar texto, colocar formas e imágenes, crear gráficos y tablas, aplicar temas, ejecutar VBA, exportar a PDF o video y gestionar ventanas de PowerPoint en vivo de forma segura a través de la API COM nativa.

Origen y crédito: Este proyecto se basa en la base de automatización MCP original creada por Stefan Broenner (sbroenne) en mcp-server-excel, extendida aquí a un conjunto de herramientas completo centrado en PowerPoint.

Lanzamientos y paquetes: GitHub Releases | NuGet: PptMcp.McpServer | NuGet: PptMcp.CLI

Para flujos de trabajo de compilación / verificación / reparación en múltiples fases desde el código fuente, el repositorio también incluye el cliente de orquestación oficial en src\PptMcp.Agent.

🛡️ 100% Seguro: usa la API COM nativa de PowerPoint — Cero riesgo de corrupción de archivos. Utiliza la API COM oficial de PowerPoint, lo que garantiza total seguridad y compatibilidad.

💡 Desarrollo interactivo — Ve los resultados al instante en PowerPoint. Añade diapositivas, crea gráficos, formatea texto e itera. PowerPoint se convierte en tu espacio de trabajo impulsado por IA.

Requisitos técnicos:

• ⚠️ Solo Windows — La interoperabilidad COM es específica de Windows

• ⚠️ PowerPoint requerido — Debe estar instalado Microsoft PowerPoint 2016 o posterior

• ⚠️ Entorno de escritorio — Controla el proceso real de PowerPoint (no para procesamiento en servidor)

🎯 Lo que puedes hacer

33 herramientas especializadas con 223 operaciones:

• 📁 Archivos (1 herramienta, 6 operaciones) — Abrir, cerrar, crear, guardar, listar, validar presentaciones

• 📄 Diapositivas (1 herramienta, 15 operaciones) — Crear, duplicar, mover, eliminar, aplicar diseños, ocultar/mostrar, miniaturas, clonar con reemplazo

• 🔷 Formas (1 herramienta, 35 operaciones) — Añadir, mover, redimensionar, relleno, degradado, línea, sombra, brillo, reflejo, opacidad, 3D, rotación, orden z, agrupación, conectores, combinar, voltear, escalar

• ✏️ Texto (1 herramienta, 18 operaciones) — Obtener/establecer texto, buscar, reemplazar, formato, espaciado, viñetas, mayúsculas/minúsculas, símbolos, auditoría de texto alternativo

• 📋 Tablas de diapositivas (1 herramienta, 13 operaciones) — Crear, leer/escribir celdas y filas, añadir/eliminar filas y columnas, combinar, formato, bordes

• 📊 Gráficos (1 herramienta, 10 operaciones) — Crear, establecer datos, título, tipo, leyenda, títulos de ejes, tabla de datos

• 🖼️ Imágenes (1 herramienta, 4 operaciones) — Insertar, recortar, brillo/contraste, color transparente

• 🎥 Multimedia (1 herramienta, 4 operaciones) — Insertar audio/video, información multimedia, configuración de reproducción

• 🧩 SmartArt (1 herramienta, 6 operaciones) — Información del diagrama, añadir/eliminar nodos, diseño, estilo, cambios de nivel

• 🎨 Diseño/Temas (1 herramienta, 19 operaciones) — Temas, esquemas de color, fuentes, arquetipos, paletas, cuadrículas de diseño, perfiles de estilo

• 🖌️ Fondo de diapositiva (1 herramienta, 5 operaciones) — Obtener, color sólido, degradado, imagen, restablecer al patrón

• 🎭 Patrones y diseños (1 herramienta, 5 operaciones) — Listar patrones y diseños, editar formas del patrón, eliminar no utilizados

• 📌 Marcadores de posición (1 herramienta, 3 operaciones) — Listar marcadores, establecer texto, establecer imagen

• 📃 Encabezados y pies de página (1 herramienta, 2 operaciones) — Obtener/establecer texto de pie de página, números de diapositiva, fecha

• 📐 Configuración de página (1 herramienta, 3 operaciones) — Tamaño de diapositiva, orientación, número de primera diapositiva

• ↔️ Alineación de formas (1 herramienta, 2 operaciones) — Alinear y distribuir formas en diapositivas

• 🎬 Animaciones (1 herramienta, 6 operaciones) — Listar, añadir, eliminar, borrar, temporización, reordenar

• 🔀 Transiciones (1 herramienta, 4 operaciones) — Obtener, establecer, eliminar, copiar a todas las diapositivas

• 📺 Presentación (1 herramienta, 5 operaciones) — Iniciar, detener, navegar, estado, configurar

• 🎞️ Presentaciones personalizadas (1 herramienta, 3 operaciones) — Crear, listar, eliminar presentaciones personalizadas

• 📂 Secciones (1 herramienta, 4 operaciones) — Listar, añadir, renombrar, eliminar secciones de presentación

• 📥 Importación de diapositivas (1 herramienta, 1 operación) — Importar diapositivas de otro archivo .pptx

• 📝 Notas (1 herramienta, 5 operaciones) — Obtener, establecer, borrar, añadir, leer todas las notas del orador

• 💬 Comentarios (1 herramienta, 4 operaciones) — Añadir, listar, eliminar, borrar comentarios de diapositivas

• 🔗 Hipervínculos (1 herramienta, 5 operaciones) — Añadir, obtener, listar, eliminar, validar hipervínculos

• 🏷️ Etiquetas (1 herramienta, 3 operaciones) — Metadatos personalizados en diapositivas y formas

• 🗂️ Propiedades del documento (1 herramienta, 4 operaciones) — Obtener/establecer propiedades integradas y personalizadas

• ♿ Accesibilidad (1 herramienta, 3 operaciones) — Auditar, obtener/establecer orden de lectura

• 🔤 Revisión (1 herramienta, 3 operaciones) — Corrección ortográfica, obtener/establecer idioma

• 📤 Exportación (1 herramienta, 9 operaciones) — PDF, imágenes de diapositivas, video (MP4), imprimir, guardar como, extraer texto/imágenes

• 🖨️ Opciones de impresión (1 herramienta, 2 operaciones) — Obtener/establecer configuración de impresión

• ⚙️ VBA (1 herramienta, 5 operaciones) — Listar, ver, importar, eliminar, ejecutar macros

• 🪟 Ventana (1 herramienta, 7 operaciones) — Información, minimizar, restaurar, maximizar, zoom, modo de vista

📚 Referencia completa de funciones → — Documentación detallada de las 223 operaciones

Related MCP server: Office-PowerPoint-MCP

💬 Ejemplos de indicaciones

Crear y construir presentaciones:

• "Crea una nueva presentación de PowerPoint llamada QuarterlyReport.pptx con una diapositiva de título"

• "Añade 5 diapositivas con un diseño de 'Título y contenido'"

• "Inserta un logotipo de empresa en la primera diapositiva"

Contenido y formato:

• "Añade un cuadro de texto en la diapositiva 2 con el texto 'Resumen de ingresos del primer trimestre' en Arial 24pt en negrita"

• "Crea una tabla en la diapositiva 3 con columnas para Región, Q1, Q2, Q3, Q4"

• "Establece el color de relleno de la forma a #0078D4 y añade un borde de 2pt"

Gráficos y elementos visuales:

• "Crea un gráfico de barras en la diapositiva 4 que muestre los datos de ingresos trimestrales"

• "Establece el título del gráfico a 'Ingresos por trimestre'"

• "Añade una animación de entrada a la forma del gráfico"

Automatización:

• "Exporta la presentación como PDF"

• "Ejecuta la macro FormatAllSlides"

• "Muéstrame PowerPoint mientras trabajas" — observa los cambios en tiempo real

🪟 Modo agente: observa a la IA trabajar en PowerPoint:

• "Muéstrame PowerPoint en paralelo mientras construyes esta presentación" — visibilidad en tiempo real

• "Déjame ver mientras creas las diapositivas"

• La barra de estado muestra el progreso en vivo: "PptMcp: Creando gráfico en la diapositiva 4..."

👥 ¿Quién debería usar esto?

Perfecto para:

• ✅ Presentadores que automatizan flujos de trabajo repetitivos de PowerPoint

• ✅ Desarrolladores que crean soluciones de informes basadas en PowerPoint

• ✅ Usuarios empresariales que gestionan presentaciones complejas

• ✅ Equipos que mantienen plantillas de presentación y macros VBA

No adecuado para:

• ❌ Procesamiento en servidor (usa bibliotecas como Open XML SDK en su lugar)

• ❌ Usuarios de Linux/macOS (se requiere Windows + instalación de PowerPoint)

• ❌ Operaciones por lotes de alto volumen (considera alternativas sin PowerPoint)

🚀 Inicio rápido

⚠️ Importante: Cierra todos los archivos de PowerPoint antes de usar. El servidor requiere acceso exclusivo a las presentaciones durante la automatización.

🔧 CLI vs Servidor MCP

Este paquete proporciona interfaces tanto de CLI como de Servidor MCP. Elige según tu caso de uso:

Instalación manual:

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

🤖 Opcional: Cliente agente oficial desde el código fuente

Para tareas más grandes de construcción de presentaciones, este repositorio también incluye un controlador oficial del lado del cliente: src\PptMcp.Agent.

Intencionalmente no es una tercera superficie de servidor. En cambio, se sitúa por encima del servidor MCP y ejecuta un bucle del lado del cliente:

• planificar la presentación

• ejecutar mediante llamadas normales secuenciales de herramientas MCP

• verificar la presentación generada

• reparar la salida incompleta cuando sea necesario

Inicio rápido:

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"

Leer más:

• README del componente cliente agente

• Arquitectura del cliente agente

• Marco de evaluación

• Canalización de arquetipos

⚙️ Cómo funciona: automatización COM y arquitectura de servicio unificada

PptMcp utiliza automatización COM de Windows para controlar la aplicación real de PowerPoint (no solo archivos .pptx).

Tanto el Servidor MCP como la CLI se comunican con un Servicio PptMcp compartido que gestiona las sesiones de PowerPoint. Esta arquitectura unificada permite:

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

Beneficios clave:

• ✅ Sesiones compartidas — La CLI y el Servidor MCP pueden acceder a las mismas presentaciones abiertas

• ✅ Instancia única de PowerPoint — Sin procesos duplicados ni bloqueos de archivos

• ✅ Interfaz de bandeja del sistema — Supervisa las sesiones activas mediante el icono de bandeja de PptMcp

💡 Consejo: observa PowerPoint mientras la IA trabaja De forma predeterminada, PowerPoint se ejecuta oculto para una automatización más rápida. Para ver los cambios en tiempo real, solo pregunta:

• "Muéstrame PowerPoint mientras trabajas"

• "Déjame ver lo que estás haciendo"

• "Abre PowerPoint para que pueda ver los cambios"

La IA mostrará la ventana de PowerPoint para que puedas ver cada operación en vivo.

📋 Información adicional

📚 Guía de CLI → | Guía del Servidor MCP → | Cliente agente → | Marco de evaluación → | Canalización de arquetipos → | Todas las habilidades del agente →

Licencia: Licencia MIT: consulta el archivo LICENSE

Contribuciones: Consulta CONTRIBUTING.md para obtener pautas

Construido con: Todo este proyecto se desarrolló con la asistencia de IA de GitHub Copilot, principalmente con Claude, pero últimamente con Auto-mode.

Agradecimientos:

• Equipo de Microsoft PowerPoint: por las API integrales de automatización COM

• Comunidad de Model Context Protocol: por el estándar de integración de IA

• Comunidad de código abierto: por la inspiración y las mejores prácticas

Proyectos relacionados

Proyectos ascendentes de Stefan Broenner:

• mcp-server-excel (ascendente) — Servidor MCP original para Excel de Stefan Broenner

• pytest-aitest — Marco de pruebas impulsado por LLM para agentes de IA