Back to MCP directory
publicPublicdnsLocal runtime

slidespeak

一个基于Docker的MCP服务器,用于通过SlideSpeak自动化创建PowerPoint演示文稿,支持报告和幻灯片生成。

article

README

🚀 Slidespeak-MCP 服务

Slidespeak-MCP 服务是一个 MCP 服务器,它能让您借助 SlideSpeak 来创建 PowerPoint 演示文稿。有了 SlideSpeak 的强大功能,现在您可以利用 SlideSpeak MCP 轻松开启自动化报告、演示文稿及其他幻灯片讲义的创建工作。

🚀 快速开始

需求

使用 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 密钥:https://slidespeak.co/slidespeak-api/

💻 使用示例

开发 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。 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