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 以檢查狀態,並在生成完成時取得下載 URL。
  • 匯出含音訊的投影片 — 使用 slides_download_slides_pages_voices 取得包含頁面圖片、旁白 WAV 檔案及逐字稿的 ZIP 壓縮檔。

文件

2slides MCP 伺服器

2slides

將 2slides.com 的工具開放給 MCP 用戶端:產生 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)

使用預先建置的主題(Fast 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 工作(僅限 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。

參考資料