slidespeak-mcp

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/

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