2slides

官方

這是全球第一個、最簡單且最便宜的PPT、投影片、簡報AI生成MCP伺服器。

你可以用 2slides MCP 做什麼?

  • 搜尋簡報主題 — 使用 themes_search 依關鍵字(例如「商業」、「極簡」)尋找主題,並取得其 themeId 以用於投影片生成。
  • 生成主題式 PowerPoint 投影片 — 提供內容與 themeIdslides_generate,即可取得可直接下載的 .pptx 檔案。
  • 根據參考圖片建立投影片 — 提供參考圖片的網址與內容給 slides_create_like_this,即可產出模仿該圖片視覺風格的投影片。
  • 從文字建立自訂設計投影片 — 使用 slides_create_pdf_slides 並搭配自由文字 designStyle,無需參考圖片即可生成投影片。
  • 為投影片加入 AI 語音旁白 — 使用 slides_generate_narration 為已完成的 Nano Banana 投影片任務附加單人或多人口白。
  • 將投影片與音訊匯出為 ZIP — 使用 slides_download_pages_voices 下載個別投影片圖片、每頁音訊檔案,以及有旁白任務的文字稿。

文件

2slides MCP 伺服器

2slides

為 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)

使用預先建置的主題(Fast PPT)產生 PowerPoint 簡報。請先使用 themes_search 來尋找 themeId

  • 參數:
    • userInput (字串,必填) — 簡報內容
    • themeId (字串,必填) — 來自 themes_search 的主題 ID
    • responseLanguage (字串,選填,預設值:Auto) — 輸出語言;支援的值:AutoEnglishSpanishArabicPortugueseIndonesianJapaneseRussianHindiFrenchGermanGreekVietnameseTurkishThaiPolishItalianKoreanSimplified ChineseTraditional Chinese
    • mode (選填,預設值:sync) — sync 會立即回傳 downloadUrlasync 會回傳一個 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 (字串,必填) — 搜尋關鍵字(例如 businessminimaldark
    • limit (數字,選填,預設值:10,範圍:1–100)
  • 回傳: 包含 idnamedescriptionpreviewUrltags 的主題陣列
  • 點數: 免費
  • 範例:
    { "query": "business", "limit": 5 }
    

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

輪詢工作的狀態,並在準備就緒時擷取結果。

  • 參數:
    • jobId (字串,必填)
  • 回傳: jobIdstatus (pending / processing / success / failed)、messagedownloadUrl (成功時)、slidePageCountcreatedAtupdatedAtduration (毫秒)、jobUrl (僅限 Nano Banana 工作)
  • 點數: 免費
  • 注意: 每 20 秒輪詢一次,直到 statussuccessfailed
  • 範例:
    { "jobId": "D8h9VYDGdTlZ6wWSEoctF" }
    

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

產生與參考圖片風格相符的投影片(Nano Banana)。

  • 參數:
    • userInput (字串,必填) — 簡報內容
    • referenceImageUrl (字串,必填) — 風格參考圖片的 URL
    • responseLanguage (字串,選填,預設值:Auto)
    • aspectRatio (字串,選填,預設值:16:9) — 有效值:1:12:33:23:44:34:55:49:1616:921:9
    • resolution (字串,選填,預設值:2K) — 1K2K4K
    • page (數字,選填,預設值:0) — 0 = 自動偵測,1–100 = 精確頁數
    • contentDetail (字串,選填,預設值:standard) — concisestandard
    • mode (字串,選填,預設值:async) — async 會回傳 jobIdsync 會立即回傳 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:12:33:23:44:34:55:49:1616:921:9
    • resolution (字串,選填,預設值:2K) — 1K2K4K
    • page (數字,選填,預設值:0) — 0 = 自動偵測,1–100 = 精確頁數
    • contentDetail (字串,選填,預設值:standard) — concisestandard
    • mode (字串,選填,預設值:async) — async 會回傳 jobIdsync 會立即回傳 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_thisslides_create_pdf_slides;不支援 Fast PPT)加入 AI 語音旁白。一律為非同步 — 使用 jobs_get 輪詢結果。

  • 參數(單一講者,mode: "single" 預設):

    • jobId (字串,必填) — 已完成的 Nano Banana 工作的 UUID
    • mode (字串,選填,預設值:single) — singlemulti
    • speakerName (字串,選填) — 旁白者名稱
    • voice (字串,選填) — 30 種聲音之一(請參閱下方列表)
    • contentMode (字串,選填,預設值:standard) — concisestandard
    • includeIntro (布林值,選填,預設值:true)
  • 參數(兩位講者,mode: "multi"):

    • jobId (字串,必填)
    • mode (字串,必填) — multi
    • speaker1Name (字串,必填)
    • speaker2Name (字串,必填)
    • speaker1Voice (字串,選填) — 講者 1 的聲音
    • speaker2Voice (字串,選填) — 講者 2 的聲音
    • contentMode (字串,選填,預設值:standard) — concisestandard
  • 支援的聲音(30 種): PuckAoedeCharonKoreFenrirZephyrLedaOrusCallirrhoeAutonoeEnceladusIapetusUmbrielAlgiebaDespinaErinomeAlgenibRasalgethiLaomedeiaAchernarAlnilamSchedarGacruxPulcherrimaAchirdZubenelgenubiVindemiatrixSadachbiaSadaltagerSulafat

  • 點數: 每頁 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 小時後過期)、fileNameexpiresIn (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_thisslides_create_pdf_slides (非同步) → 取得 jobId
  2. jobs_get (每 20 秒輪詢) → 當 status: "success" 時取得 downloadUrl

Nano Banana 搭配旁白:

  1. slides_create_like_thisslides_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。

參考資料