2slides MCP Server

2slides MCP 服务

向 MCP 客户端提供 2slides.com 工具：生成 PowerPoint 演示文稿和定制设计的幻灯片、添加 AI 语音旁白，并通过下载链接获取生成的文件。

获取 API 密钥

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

连接

2slides 提供托管的 Streamable HTTP MCP 端点，同时也提供这个 stdio 程序包。两者都通过同一账户和同一额度提供相同的 7 个工具。

	Streamable HTTP	stdio（此程序包）
设置	一条命令，无需安装	需要 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)

使用预构建主题（Fast PPT）生成 PowerPoint 演示文稿。请先使用 themes_search 查找 themeId。

• 参数：
  • userInput（string，必填）— 演示文稿内容
  • themeId（string，必填）— 从 themes_search 获取的主题 ID
  • responseLanguage（string，可选，默认值：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（string，必填）— 搜索关键词（例如 business、minimal、dark）
  • limit（number，可选，默认值：10，范围：1–100）
• 返回： 包含 id、name、description、previewUrl、tags 的主题数组
• 额度： 免费
• 示例：

  { "query": "business", "limit": 5 }
  

---

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

轮询任务状态，并在任务就绪时获取结果。

• 参数：
  • jobId（string，必填）
• 返回： jobId、status（pending / processing / success / failed）、message、downloadUrl（成功时）、slidePageCount、createdAt、updatedAt、duration（ms）、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 任务添加 AI 语音旁白（仅支持 slides_create_like_this 或 slides_create_pdf_slides；不支持 Fast PPT）。始终为异步操作——使用 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" }
  

---

典型工作流

快速生成 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（每隔 20s 轮询）→ 当 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 输出错误日志。

参考资料

• 构建 MCP 服务（官方文档）：https://modelcontextprotocol.io/docs/develop/build-server
• 2slides API 文档：https://2slides.com/api
• 2slides：https://2slides.com
• 2slides 模板：https://2slides.com/templates