PPT maker MCP server

🌐 中文版README

This MCP server enables dynamic creation, editing and saving of PowerPoint presentations. Built upon the MCP and using the python-pptx library, it provides a flexible interface to add slides, images, tables, and other elements. Users could effortlessly make, edit and save presentations by simply chatting with a large language model, streamlining the entire workflow

Features

• Create Presentations
  Initialize a new PowerPoint presentation using a title that generates a unique presentation ID.

• Slide Operations

  • Title Slide: Add a title slide with an optional subtitle.
  • Content Slide: Create slides with a title and bullet-point content.
  • Section Slide: Insert a section divider slide with a large centered title and an optional background color.
  • Image Slide: Add slides featuring images from local files or URLs with titles and descriptive alt text.
  • Table Slide: Insert slides containing tables with defined headers and row data.

• Presentation Management

  • Save Presentation: Write the presentation to a specified file path, handling temporary directories if needed.
  • Download Link: Generate a data URI with base64-encoded presentation content for direct download.
  • Presentation Info: Retrieve metadata about the presentation such as the number of slides and available slide layouts.
  • Presentation Outline: Obtain a text-based outline of the presentation structure via a dedicated resource endpoint.
  • Remove Slide: Delete a slide by its 1-based index.
  • Export to Base64: Export the complete presentation as a base64-encoded string for further processing.

Installation

1. Clone the Repository

   git clone https://github.com/ltc6539/mcp-ppt.git
   cd mcp-ppt
   

2. Create a Virtual Environment (Optional but Recommended)

   python3 -m venv .venv
   source .venv/bin/activate  # On Windows use: .venv\Scripts\activate
   

3. Then add MCP to your project dependencies

   uv add "mcp[cli]"
   uv run mcp
   

You can install this server in Claude Desktop and interact with it right away by running:

mcp install server-local.py

Alternatively, you can test it with the MCP Inspector:

mcp dev server-local.py

If the claude desktop has error, You may need to put the full path to the uv executable in the command field. You can get this by running which uv on MacOS/Linux or where uv on Windows. During startup, the server logs Python and python-pptx version information to stderr. Any errors during execution are also printed to stderr for easy debugging.

Tool List

Each MCP tool function is directly accessible via the MCP server. Below are the primary operations available:

1. Create Presentation

• Function: create_presentation(title: str) -> str
• Description: Initializes a new presentation and returns a unique presentation ID.

2. Add Title Slide

• Function: add_title_slide(prs_id: str, title: str, subtitle: Optional[str] = None) -> str
• Description: Adds a title slide to the specified presentation.

3. Add Content Slide

• Function: add_content_slide(prs_id: str, title: str, content: List[str]) -> str
• Description: Inserts a content slide with a title and multiple bullet points.

4. Add Section Slide

• Function: add_section_slide(prs_id: str, section_title: str, background_color: Optional[str] = None) -> str
• Description: Creates a section divider slide with a customizable background color and large, centered text.

5. Add Image Slide

• Function: add_image_slide(prs_id: str, title: str, image_path: str, image_description: str) -> str
• Description: Adds an image slide. The image can be loaded from a l

... View full README on GitHub