2slides

官方

这是全球首个、最简单且最便宜的PPT、幻灯片、演示文稿AI生成MCP服务器。

你可以用 2slides MCP 做什么?

  • 搜索演示主题 — 在生成演示文稿前,使用 themes_search 按“商务”或“极简”等关键词查找预建主题。
  • 生成主题化 PowerPoint — 调用 slides_generate,传入 themeId 和内容,即可生成可下载的 PPT,可选择同步或异步模式。
  • 创建自定义设计幻灯片 — 使用 slides_create_pdf_slides 或 slides_create_like_this,从文本或参考图片生成具有自定义样式的 Nano Banana 幻灯片。
  • 添加 AI 语音旁白 — 对已完成的 Nano Banana 任务应用 slides_generate_narration,可从 30 种可用声音中选择单人或双人播报。
  • 跟踪任务进度 — 每 20 秒轮询 jobs_get 以检查状态,并在生成完成时获取下载链接。
  • 导出带音频的幻灯片 — 使用 slides_download_slides_pages_voices 获取包含页面图像、旁白 WAV 文件和文字记录的 ZIP 压缩包。

文档

2slides MCP 服务器

2slides

向 MCP 客户端暴露 2slides.com 的工具:生成 PowerPoint 演示文稿和自定义设计的幻灯片,添加 AI 语音旁白,并将完成的文件以下载链接的形式返回。

获取 API 密钥

连接之前,请从 2slides.com/api 获取 API 密钥。

连接

2slides 运行一个托管的 Streamable HTTP MCP 端点,同时也提供这个 stdio 包。两者在同一个账户和相同的积分体系下暴露相同的 7 个工具。

Streamable HTTPstdio(本包)
设置一条命令,无需安装需要 Node.js 18+,npx 获取包
更新服务端,始终最新在您的机器上重新下载
运行于任何支持远程的 MCP 客户端任何可以启动本地进程的客户端

选项 1 — Streamable HTTP(推荐)

Anthropic 的 MCP 文档称 HTTP 为“连接远程 MCP 服务器的推荐选项”,而 2slides 是一个托管服务,没有需要访问的本地文件或进程,因此从这里开始。

Claude Code

claude mcp add --transport http 2slides "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

使用 claude mcp list 验证 — 服务器应报告 ✔ Connected。

项目配置(.mcp.json,与您的团队共享)

{
  "mcpServers": {
    "2slides": {
      "type": "http",
      "url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
    }
  }
}

Claude Desktop / claude.ai:在 claude.ai/customize/connectors 将其添加为自定义连接器,使用相同的 URL。

选项 2 — stdio(本地进程)

当客户端只能启动本地进程、机器无法直接访问 2slides.com,或者您想自行固定和修补服务器时,请使用此选项。

Claude Code

claude mcp add 2slides -e API_KEY=YOUR_2SLIDES_API_KEY -- npx -y 2slides-mcp@latest

Claude Desktop — 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json(Windows 上为 %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "2slides": {
      "command": "npx",
      "args": ["-y", "2slides-mcp@latest"],
      "env": {
        "API_KEY": "YOUR_2SLIDES_API_KEY"
      }
    }
  }
}

-y 标志允许 npx 在无提示的情况下安装包。之后完全重启 Claude Desktop;在聊天中打开工具面板,您应该会看到以下工具。

可用工具


slides_generate(POST /api/v1/slides/generate)

使用预建主题生成 PowerPoint 演示文稿(Fast PPT)。先使用 themes_search 查找 themeId。

  • 参数:
    • userInput(字符串,必填)— 演示文稿内容
    • themeId(字符串,必填)— 来自 themes_search 的主题 ID
    • responseLanguage(字符串,可选,默认:Auto)— 输出语言;支持的值:Auto、English、Spanish、Arabic、Portuguese、Indonesian、Japanese、Russian、Hindi、French、German、Greek、Vietnamese、Turkish、Thai、Polish、Italian、Korean、Simplified Chinese、Traditional Chinese
    • mode(可选,默认:sync)— sync 立即返回 downloadUrl;async 返回 jobId 以使用 jobs_get 轮询
  • 积分: 每页 1 积分
  • 示例:
    {
      "themeId": "st-1756528793701-fcg5fblt2",
      "userInput": "Generate a 5-slide intro to machine learning",
      "responseLanguage": "English",
      "mode": "sync"
    }
    

themes_search(GET /api/v1/themes/search)

搜索预建主题以与 slides_generate 一起使用。

  • 参数:
    • query(字符串,必填)— 搜索关键词(例如 business、minimal、dark)
    • limit(数字,可选,默认:10,范围:1–100)
  • 返回: 主题数组,包含 id、name、description、previewUrl、tags
  • 积分: 免费
  • 示例:
    { "query": "business", "limit": 5 }
    

jobs_get(GET /api/v1/jobs/{jobId})

轮询作业状态并在就绪时获取结果。

  • 参数:
    • jobId(字符串,必填)
  • 返回: jobId、status(pending / processing / success / failed)、message、downloadUrl(成功时)、slidePageCount、createdAt、updatedAt、duration(毫秒)、jobUrl(仅 Nano Banana 作业)
  • 积分: 免费
  • 注意: 每 20 秒轮询一次,直到 status 为 success 或 failed。
  • 示例:
    { "jobId": "D8h9VYDGdTlZ6wWSEoctF" }
    

slides_create_like_this(POST /api/v1/slides/create-like-this)

生成与参考图片风格匹配的幻灯片(Nano Banana)。

  • 参数:
    • userInput(字符串,必填)— 演示文稿内容
    • referenceImageUrl(字符串,必填)— 风格参考图片的 URL
    • responseLanguage(字符串,可选,默认:Auto)
    • aspectRatio(字符串,可选,默认:16:9)— 有效值:1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9
    • resolution(字符串,可选,默认:2K)— 1K、2K、4K
    • page(数字,可选,默认:0)— 0 = 自动检测,1–100 = 精确页数
    • contentDetail(字符串,可选,默认:standard)— concise 或 standard
    • mode(字符串,可选,默认:async)— async 返回 jobId;sync 立即返回 downloadUrl
  • 积分: 每页 100 积分(1K/2K)或每页 200 积分(4K)
  • 示例:
    {
      "userInput": "Create a presentation about AI trends",
      "referenceImageUrl": "https://example.com/style-reference.jpg",
      "aspectRatio": "16:9",
      "resolution": "2K",
      "page": 5,
      "contentDetail": "standard",
      "mode": "async"
    }
    

slides_create_pdf_slides(POST /api/v1/slides/create-pdf-slides)

从文本内容生成自定义设计的幻灯片(Nano Banana),无需参考图片。

  • 参数:
    • userInput(字符串,必填)— 演示文稿内容
    • designStyle(字符串,可选)— 视觉样式的自由文本描述;留空使用默认样式
    • responseLanguage(字符串,可选,默认:Auto)
    • aspectRatio(字符串,可选,默认:16:9)— 有效值:1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9
    • resolution(字符串,可选,默认:2K)— 1K、2K、4K
    • page(数字,可选,默认:0)— 0 = 自动检测,1–100 = 精确页数
    • contentDetail(字符串,可选,默认:standard)— concise 或 standard
    • mode(字符串,可选,默认:async)— async 返回 jobId;sync 立即返回 downloadUrl
  • 积分: 每页 100 积分(1K/2K)或每页 200 积分(4K)
  • 示例:
    {
      "userInput": "Quarterly business review for Q3 2025",
      "designStyle": "modern, dark background, bold typography",
      "aspectRatio": "16:9",
      "resolution": "2K",
      "page": 8,
      "mode": "async"
    }
    

slides_generate_narration(POST /api/v1/slides/generate-narration)

为已完成的 Nano Banana 作业(仅限 slides_create_like_this 或 slides_create_pdf_slides;不支持 Fast PPT)添加 AI 语音旁白。始终异步 — 使用 jobs_get 轮询结果。

  • 参数(单说话人,mode: "single" 默认):

    • jobId(字符串,必填)— 已完成的 Nano Banana 作业的 UUID
    • mode(字符串,可选,默认:single)— single 或 multi
    • speakerName(字符串,可选)— 旁白者名称
    • voice(字符串,可选)— 30 种声音之一(见下方列表)
    • contentMode(字符串,可选,默认:standard)— concise 或 standard
    • includeIntro(布尔值,可选,默认:true)
  • 参数(双说话人,mode: "multi"):

    • jobId(字符串,必填)
    • mode(字符串,必填)— multi
    • speaker1Name(字符串,必填)
    • speaker2Name(字符串,必填)
    • speaker1Voice(字符串,可选)— 说话人 1 的声音
    • speaker2Voice(字符串,可选)— 说话人 2 的声音
    • contentMode(字符串,可选,默认:standard)— concise 或 standard
  • 支持的声音(30 种): Puck、Aoede、Charon、Kore、Fenrir、Zephyr、Leda、Orus、Callirrhoe、Autonoe、Enceladus、Iapetus、Umbriel、Algieba、Despina、Erinome、Algenib、Rasalgethi、Laomedeia、Achernar、Alnilam、Schedar、Gacrux、Pulcherrima、Achird、Zubenelgenubi、Vindemiatrix、Sadachbia、Sadaltager、Sulafat

  • 积分: 每页 210 积分(10 文本 + 200 音频)

  • 示例:

    {
      "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "mode": "multi",
      "speaker1Name": "Alice",
      "speaker2Name": "Bob",
      "speaker1Voice": "Aoede",
      "speaker2Voice": "Puck",
      "contentMode": "standard"
    }
    

slides_download_slides_pages_voices(POST /api/v1/slides/download-slides-pages-voices)

将幻灯片页面和音频旁白导出为 ZIP 文件。作业必须已完成并生成了旁白。

  • 参数:
    • jobId(字符串,必填)— 已完成旁白的作业的 UUID
  • 返回: downloadUrl(1 小时内过期)、fileName、expiresIn(3600 秒)
  • ZIP 内容:
    pages/
      page_01.png, page_02.png, …
    voices/
      page_01.wav, page_02.wav, …
    transcript.txt
    
  • 积分: 免费
  • 示例:
    { "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" }
    

典型工作流

Fast PPT(基于主题的 PowerPoint):

  1. themes_search → 获取 themeId
  2. slides_generate(同步)→ 直接获取 downloadUrl

Nano Banana(自定义设计的幻灯片):

  1. slides_create_like_this 或 slides_create_pdf_slides(异步)→ 获取 jobId
  2. jobs_get(每 20 秒轮询)→ 当 status: "success" 时获取 downloadUrl

带旁白的 Nano Banana:

  1. slides_create_like_this 或 slides_create_pdf_slides → 获取 jobId
  2. jobs_get → 等待幻灯片完成
  3. slides_generate_narration → 获取旁白 jobId
  4. jobs_get → 等待旁白完成
  5. slides_download_slides_pages_voices → 获取 ZIP 下载链接

故障排除(Claude Desktop)

  • 如果工具未出现在 Claude 中,请验证配置路径是否为绝对路径并重启应用。
  • 检查 Claude MCP 日志:
tail -n 50 -f ~/Library/Logs/Claude/mcp*.log
  • 对于 stdio MCP 服务器,避免向 stdout 记录日志;此服务器仅向 stderr 记录错误。

参考