2slides

2slides MCP 服务器

为 MCP 客户端（例如 Claude Desktop）提供 2slides.com 工具。

获取您的 API 密钥

在使用此 MCP 服务器之前，您需要从 2slides.com/api 获取一个 API 密钥。

在 Claude Desktop 中配置

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json 并添加：

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

然后完全重启 Claude Desktop。在聊天中，打开工具面板，您应该会看到以下工具。

可用工具

---

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

使用预构建主题（快速 PPT）生成 PowerPoint 演示文稿。请先使用 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 作业添加 AI 语音旁白（仅限 slides_create_like_this 或 slides_create_pdf_slides；不支持快速 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_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（每 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_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