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.

Related MCP server: PowerPoint MCP Server

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:

python server.py

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:

HOST=0.0.0.0 PORT=9000 python server.py

O (para desarrollo con FastMCP):

fastmcp dev server.py

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.