Back to MCP directory
publicPublicdnsLocal runtime

SlideSpeak

一个基于Docker的MCP服务器,用于自动化创建PowerPoint演示文稿

article

README

🚀 slidespeak-mcp 服务端

slidespeak-mcp 是一个 MCP 服务器,借助它,您能够使用 SlideSpeak 轻松创建 PowerPoint 演示文稿。利用 SlideSpeak 的强大功能,可实现报告、演示及其他幻灯片文稿制作的自动化。现在就开启高效制作之旅吧!

🚀 快速开始

需求

与 Claude Desktop 结合使用

若要与 Claude Desktop 一同使用,需将以下内容添加到您的 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"
      }
    }
  }
}

获取 API 密钥

访问以下页面以获取 Slidespeak 的 API 密钥:获取 API 密钥

💻 使用示例

基础用法

将上述 Docker 配置添加到 claude_desktop_config.json 文件后,即可开始使用 SlideSpeak 自动化创建 PowerPoint 演示文稿。

高级用法

SlideSpeak MCP 的开发

以下信息与 SlideSpeak MCP 的开发相关,这些步骤对于使用 MCP 并非必需。

构建 Docker 镜像

此命令用于本地测试,若您想发布新版本,请参阅下方的“制作新版本”部分。

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

开发步骤

安装 uv 工具
curl -LsSf https://astral.sh/uv/install.sh | sh
创建虚拟环境并激活它

运行以下命令创建和激活虚拟环境:

uv venv
source .venv/bin/activate
安装依赖项
uv pip install -r requirements.txt

直接使用服务器(无需 Docker)

将以下内容添加到您的 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"
      }
    }
  }
}

制作新版本

版本命名应遵循格式 MAJOR.MINOR.PATCH(例如,1.0.0)。 需要在以下文件中更新版本号:

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

在 GitHub 上发布新版本,并使用版本号进行标记,这将触发 GitHub Actions,新版本将自动构建并推送到 Docker Hub。

Docker 镜像地址:https://hub.docker.com/r/slidespeak/slidespeak-mcp

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client