2slides
官方這是全球第一個、最簡單且最便宜的PPT、投影片、簡報AI生成MCP伺服器。
你可以用 2slides MCP 做什麼?
- 搜尋簡報主題 — 使用
themes_search依關鍵字(例如「商業」、「極簡」)尋找主題,並取得其themeId以用於投影片生成。 - 生成主題式 PowerPoint 投影片 — 提供內容與
themeId給slides_generate,即可取得可直接下載的.pptx檔案。 - 根據參考圖片建立投影片 — 提供參考圖片的網址與內容給
slides_create_like_this,即可產出模仿該圖片視覺風格的投影片。 - 從文字建立自訂設計投影片 — 使用
slides_create_pdf_slides並搭配自由文字designStyle,無需參考圖片即可生成投影片。 - 為投影片加入 AI 語音旁白 — 使用
slides_generate_narration為已完成的 Nano Banana 投影片任務附加單人或多人口白。 - 將投影片與音訊匯出為 ZIP — 使用
slides_download_pages_voices下載個別投影片圖片、每頁音訊檔案,以及有旁白任務的文字稿。
文件
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)
使用預先建置的主題(Fast PPT)產生 PowerPoint 簡報。請先使用 themes_search 來尋找 themeId。
- 參數:
userInput(字串,必填) — 簡報內容themeId(字串,必填) — 來自themes_search的主題 IDresponseLanguage(字串,選填,預設值:Auto) — 輸出語言;支援的值:Auto、English、Spanish、Arabic、Portuguese、Indonesian、Japanese、Russian、Hindi、French、German、Greek、Vietnamese、Turkish、Thai、Polish、Italian、Korean、Simplified Chinese、Traditional Chinesemode(選填,預設值: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(字串,必填) — 風格參考圖片的 URLresponseLanguage(字串,選填,預設值:Auto)aspectRatio(字串,選填,預設值:16:9) — 有效值:1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9resolution(字串,選填,預設值:2K) —1K、2K、4Kpage(數字,選填,預設值:0) —0= 自動偵測,1–100= 精確頁數contentDetail(字串,選填,預設值:standard) —concise或standardmode(字串,選填,預設值: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:9resolution(字串,選填,預設值:2K) —1K、2K、4Kpage(數字,選填,預設值:0) —0= 自動偵測,1–100= 精確頁數contentDetail(字串,選填,預設值:standard) —concise或standardmode(字串,選填,預設值: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 工作的 UUIDmode(字串,選填,預設值:single) —single或multispeakerName(字串,選填) — 旁白者名稱voice(字串,選填) — 30 種聲音之一(請參閱下方列表)contentMode(字串,選填,預設值:standard) —concise或standardincludeIntro(布林值,選填,預設值:true)
-
參數(兩位講者,
mode: "multi"):jobId(字串,必填)mode(字串,必填) —multispeaker1Name(字串,必填)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" }
典型工作流程
Fast PPT(基於主題的 PowerPoint):
themes_search→ 取得themeIdslides_generate(同步) → 直接取得downloadUrl
Nano Banana(自訂設計的投影片):
slides_create_like_this或slides_create_pdf_slides(非同步) → 取得jobIdjobs_get(每 20 秒輪詢) → 當status: "success"時取得downloadUrl
Nano Banana 搭配旁白:
slides_create_like_this或slides_create_pdf_slides→ 取得jobIdjobs_get→ 等待投影片完成slides_generate_narration→ 取得旁白jobIdjobs_get→ 等待旁白完成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