README.md•3 kB
# 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!
## Usage with Claude Desktop
To use this with Claude Desktop, add the following to your claude_desktop_config.json:
### Remote MCP
This is the easiest way to run the MCP. This approach requires you to have Node.js installed on your system.
([Download Node.js for free here](https://nodejs.org/en/download))
```json
{
"mcpServers": {
"slidespeak": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.slidespeak.co/mcp",
"--header",
"Authorization: Bearer YOUR-SLIDESPEAK-API-KEY-HERE"
],
"timeout": 300000
}
}
}
```
### Docker
This will allow you to run the MCP Server on your own computer. This approach requires Docker to be installed on your system.
([Download Docker Desktop for free here](https://docs.docker.com/get-started/introduction/get-docker-desktop/))
```json
{
"mcpServers": {
"slidespeak": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SLIDESPEAK_API_KEY",
"slidespeak/slidespeak-mcp:latest"
],
"env": {
"SLIDESPEAK_API_KEY": "YOUR-SLIDESPEAK-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.
```bash
docker build . -t slidespeak/slidespeak-mcp:TAG-HERE
```
### Development
#### Install uv
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
#### Create virtual environment and activate it
uv venv
source .venv/bin/activate
#### Install dependencies
```bash
uv pip install -r requirements.txt
```
### Using the server directly without Docker
Add the following to your claude_desktop_config.json:
```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