PPTX MCP Server

Servidor PPTX MCP

Un servidor con FastMCP para crear, editar y renderizar presentaciones de PowerPoint (PPTX) mediante programación. Admite la creación de diapositivas, la inserción de texto y formas, la incrustación de imágenes y la renderización de diapositivas a PNG (con LibreOffice).

Características

• Crear/Borrar presentaciones: iniciar archivos PPTX nuevos o restablecer archivos PPTX existentes.
• Agregar diapositivas: inserte diapositivas con diseños personalizables.
• Texto y contenido: agregue títulos, contenido y cuadros de texto personalizados a las diapositivas.
• Formas: inserte una amplia variedad de formas de PowerPoint (incluidos elementos de diagrama de flujo).
• Imágenes: Incruste imágenes en diapositivas.
• Descripción de la diapositiva: Obtenga un resumen textual del contenido de la diapositiva para su verificación.
• Renderizado de diapositivas: renderiza diapositivas como imágenes PNG (requiere LibreOffice).
• Descargar PPTX: Descargue el archivo de presentación generado.

Requisitos

• Python 3.12+
• python-pptx
• Almohada
• FastMCP
• LibreOffice (para renderizar imágenes de diapositivas; debe instalarse por separado y estar disponible en la RUTA de su sistema)

Instalación

1. Instalar dependencias de Python:
   pip install -r requirements.txt
   (O consulte pyproject.toml para las dependencias)
2. Instalar LibreOffice (para renderizar imágenes):
   • Linux: sudo pacman -S libreoffice-fresh o sudo apt install libreoffice
   • macOS: brew install --cask libreoffice
   • Windows: Descargar desde libreoffice.org

Uso

Iniciar el servidor:

Puede configurar el host y el puerto del servidor mediante variables de entorno:

• HOST (predeterminado: 127.0.0.1 )
• PORT (predeterminado: 8000 )

Por ejemplo, para ejecutar en todas las interfaces y el puerto 9000:

O (para desarrollo con FastMCP):

Descripción general de la API

El servidor expone herramientas y recursos a través de FastMCP, incluidos:

• create_or_clear_presentation(filename)
• add_slide(filename, layout_index)
• add_title_and_content(filename, slide_index, title, content)
• add_textbox(filename, slide_index, text, left_inches, top_inches, width_inches, height_inches, font_size_pt, bold)
• add_shape(filename, slide_index, shape_type_name, left_inches, top_inches, width_inches, height_inches, text)
• add_picture(filename, slide_index, image, left_inches, top_inches, width_inches, height_inches)
• get_slide_content_description(filename, slide_index)
• get_slide_image(filename, slide_index)(requiere LibreOffice)
• get_pptx_file(filename)

Consulte el código para obtener detalles completos de los parámetros y los tipos de formas disponibles.

Presentaciones y plantillas

• Las presentaciones se guardan en el directorio presentations/ .
• Puedes agregar tus propias plantillas en presentations/templates/ .

Licencia

Ver LICENCIA para más detalles.