Powerpoint Presentations

🚀 PPTX MCP Server

A FastMCP-based server for programmatically creating, editing, and rendering PowerPoint (PPTX) presentations. It supports slide creation, text and shape insertion, image embedding, and slide rendering to PNG (using LibreOffice).

🚀 Quick Start

To start the server, you can use the following command:

python server.py

You can set the server's host and port through environment variables:

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

For example, to run on all interfaces and use port 9000:

HOST=0.0.0.0 PORT=9000 python server.py

Or (for FastMCP in a development environment):

fastmcp dev server.py

✨ Features

• Create/Clear Presentations: Start a new or reset an existing PPTX file.
• Add Slides: Insert slides with custom layouts.
• Text and Content: Add titles, content, and custom text boxes to slides.
• Shapes: Insert a variety of PowerPoint shapes (including flowchart elements).
• Images: Embed images into slides.
• Slide Descriptions: Get a text summary of slide content for verification.
• Slide Rendering: Render slides as PNG images (requires LibreOffice).
• Download PPTX: Download the generated presentation file.

📦 Installation

1. Install Python dependencies:

   pip install -r requirements.txt
   

   (Or check pyproject.toml for dependency information)

2. Install LibreOffice (for image rendering):

   • Linux: sudo pacman -S libreoffice-fresh or sudo apt install libreoffice
   • macOS: brew install --cask libreoffice
   • Windows: Download from libreoffice.org

💻 Usage Examples

Basic Usage

python server.py

Advanced Usage

HOST=0.0.0.0 PORT=9000 python server.py

📚 Documentation

API Overview

The server provides tools and resources through FastMCP, including:

• 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) (Requires LibreOffice)
• get_pptx_file(filename)

Refer to the code for complete parameter details and available shape types.

Presentations and Templates

• Presentations are saved in the presentations/ directory.
• You can add your own templates in presentations/templates/.

📄 License

No license information provided.