Slidespeak

What is slidespeak-mcp?

slidespeak-mcp is a Micro-Controller Platform (MCP) server designed to facilitate the creation of PowerPoint presentations through the SlideSpeak API. It acts as an intermediary, allowing users to leverage the power of the SlideSpeak API to generate presentations programmatically, making it ideal for automating repetitive tasks involving slide deck creation.

How to use slidespeak-mcp?

slidespeak-mcp can be used in two primary ways: via Docker or by running the server directly.

Using with Docker

1. Requirements: Ensure Docker Desktop is installed.

2. Configuration: Add the following configuration to your claude_desktop_config.json file:

   {
     "mcpServers": {
       "slidespeak": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "-e",
           "SLIDESPEAK_API_KEY",
           "slidespeak/slidespeak-mcp:latest"
         ],
         "env": {
           "SLIDESPEAK_API_KEY": "YOUR-API-KEY-HERE"
         }
       }
     }
   }
   

3. API Key: Obtain a SlideSpeak API key from https://slidespeak.co/slidespeak-api/ and replace "YOUR-API-KEY-HERE" with your actual key.

Running the Server Directly (without Docker)

1. Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh

2. Create and Activate Virtual Environment: uv venv then source .venv/bin/activate

3. Install Dependencies: uv pip install -r requirements.txt

4. Configuration: Add the following to your claude_desktop_config.json:

   {
     "mcpServers": {
       "slidespeak": {
         "command": "/path/to/.local/bin/uv",
         "args": [
           "--directory",
           "/path/to/slidespeak-mcp",
           "run",
           "slidespeak.py"
         ],
         "env": {
           "SLIDESPEAK_API_KEY": "API-KEY-HERE"
         }
       }
     }
   }
   

   Replace /path/to/.local/bin/uv and /path/to/slidespeak-mcp with your actual paths, and API-KEY-HERE with your SlideSpeak API key.

Key Features of slidespeak-mcp

• PowerPoint Presentation Generation: Core functionality to create .pptx files.
• API-driven: Leverages the SlideSpeak API for content generation.
• Automation: Designed for automating the creation of reports, presentations, and other slide decks.
• Docker Support: Easy deployment and management via Docker containers.
• Direct Server Execution: Option to run the server directly for more control or specific environments.
• Integration with Claude Desktop: Seamless integration with Claude Desktop for managing MCP servers.

Use Cases of slidespeak-mcp

• Automated Report Generation: Automatically generate weekly, monthly, or quarterly reports in PowerPoint format from data sources.
• Personalized Presentations: Create customized presentations for individual clients or audiences based on specific data or templates.
• Batch Presentation Creation: Generate a large number of similar presentations with varying data points efficiently.
• Dynamic Content Updates: Update presentation content programmatically without manual intervention.
• Integration with Workflows: Incorporate presentation generation into existing automated workflows and systems.

FAQ about slidespeak-mcp

Q: What is an MCP Server? A: An MCP (Micro-Controller Platform) Server acts as a bridge, allowing applications to interact with specific services or APIs. In this case, slidespeak-mcp connects to the SlideSpeak API.

Q: Do I need a SlideSpeak API key to use slidespeak-mcp? A: Yes, a SlideSpeak API key is essential for slidespeak-mcp to function, as it relies on the SlideSpeak API for presentation generation. You can obtain one from https://slidespeak.co/slidespeak-api/.

Q: Can I use slidespeak-mcp without Docker? A: Yes, you can run the slidespeak-mcp server directly without Docker by following the development setup instructions, including installing uv and dependencies.

Q: How do I update slidespeak-mcp? A: For Docker users, pulling the latest image will provide the most recent version. For direct server users, updating the code and dependencies will be necessary. New releases are tagged on GitHub and automatically pushed to Docker Hub.

Q: Where can I find more information about SlideSpeak? A: You can visit the official SlideSpeak website at https://slidespeak.com/ for more details about the API and service.

slidespeak-mcp

An MCP Server that allows you to create PowerPoint presentations. Powered by SlideSpeak, you can now create presentations using the SlideSpeak MCP. Automate reports, presentations an other slide decks. Start today!

Requirements

• Docker (Download Docker Desktop for free here)

Usage with Claude Desktop

To use this with Claude Desktop, add the following to your claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "slidespeak": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SLIDESPEAK_API_KEY",
        "slidespeak/slidespeak-mcp:latest"
      ],
      "env": {
        "SLIDESPEAK_API_KEY": "YOUR-API-KEY-HERE"
      }
    }
  }
}

Getting an API key

Visit this page in order to get an API key for Slidespeak: https://slidespeak.co/slidespeak-api/

Development of SlideSpeak MCP

The following information is related to development of the SlideSpeak MCP. These steps are not needed to use the MCP.

Building the Docker Image

This is for local testing, if you want to publish a new docker container check out the "Making a new version" section below.

docker build . -t slidespeak/slidespeak-mcp:TAG-HERE

Development

Install uv

curl -LsSf https://astral.sh/uv/install.sh | sh

Create virtual environment and activate it

uv venv source .venv/bin/activate

Install dependencies

uv pip install -r requirements.txt

Using the server directly without Docker

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "slidespeak": {
      "command": "/path/to/.local/bin/uv",
      "args": [
        "--directory",
        "/path/to/slidespeak-mcp",
        "run",
        "slidespeak.py"
      ],
      "env": {
        "SLIDESPEAK_API_KEY": "API-KEY-HERE"
      }
    }
  }
}

Making a new release

Version naming should be in the format of MAJOR.MINOR.PATCH (e.g., 1.0.0).

The version needs to be updated in the following files:

• pyproject.toml -> version
• slidespeak.py -> USER_AGENT

Make a new release in GitHub and tag it with the version number. This will trigger a GitHub Action. The release will be automatically built and pushed to Docker Hub.

https://hub.docker.com/r/slidespeak/slidespeak-mcp