mcp-pptx

The MCP PPTX Server is a FastMCP-based service that lets clients generate and manipulate PowerPoint (.pptx) files through the MCP protocol. It provides capabilities to create slides, insert text and images, modify slide layouts, and apply simple formatting by accepting structured requests from MCP clients. The server exposes an RPC-style surface that can be invoked by tools or agents that speak the MCP protocol, enabling automation workflows for presentation generation and batch PPTX processing. To use it, run the server with your preferred Python environment and connect an MCP client to the specified host and port. Once running, you can send requests to modify or assemble PPTX documents and retrieve the resulting file path or binary payload as configured by the server.

Prerequisites:

• Python 3.x installed on your system
• FastMCP tooling installed (e.g., via pip install fastmcp or the project’s recommended install method)
• The MCP PPTX server files present in your project directory (as provided by the repository)

Step-by-step:

1. Install FastMCP tooling (if not already): pip install fastmcp

2. Ensure Python is available and accessible in your PATH.

3. Install or prepare the MCP PPTX server files in your project directory (the repository typically provides server.py as the entry point):

   • Place server.py and any dependencies in your working directory.

4. Run the MCP server using the provided command example from the README: fastmcp install ./server.py

5. Start the server (if you need to run directly with Python): python server.py

6. Connect an MCP client to the server using the configured host/port (default port is often 25566 unless overridden by environment variables).

Notes:

• If you modify environment variables, ensure the server process picks up PORT and TEMPLATES_DIR as needed.
• Refer to the project’s documentation for any project-specific flags or configuration options.

Tips and common issues:

• Ensure Python 3.x and FastMCP are installed correctly before starting the server.
• If you encounter port conflicts, set the PORT environment variable to an available port.
• If your PPTX templates are stored separately, set TEMPLATES_DIR to the path containing .pptx templates to enable template-based generation.
• Check file permissions for read/write access to template directories and output directories.
• When debugging, run the server in a verbose mode if supported by your FastMCP tooling to get more detailed logs.
• If you update server.py, restart the MCP server to apply changes.