返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端