2slides

resmi

Ini adalah MCP Server generasi PPT, slide, dan presentasi AI yang pertama, termudah, dan termurah di dunia.

GitHub
30

Apa yang bisa Anda lakukan dengan 2slides MCP?

  • Cari tema presentasi — Gunakan themes_search untuk menemukan tema berdasarkan kata kunci (misalnya, "bisnis", "minimal") dan dapatkan themeId untuk pembuatan slide.
  • Hasilkan slide PowerPoint bertema — Berikan konten dan themeId ke slides_generate dan terima file .pptx yang siap diunduh.
  • Buat slide yang sesuai dengan gambar referensi — Berikan URL gambar referensi dan konten ke slides_create_like_this untuk menghasilkan slide yang meniru gaya visual gambar tersebut.
  • Buat slide dengan desain kustom dari teks — Gunakan slides_create_pdf_slides dengan designStyle teks bebas untuk menghasilkan slide tanpa gambar referensi.
  • Tambahkan narasi suara AI ke slide — Gunakan slides_generate_narration untuk melampirkan narasi satu atau dua pembicara ke pekerjaan slide Nano Banana yang sudah selesai.
  • Ekspor slide dan audio sebagai ZIP — Gunakan slides_download_pages_voices untuk mengunduh gambar slide individual, file audio per halaman, dan transkrip untuk pekerjaan yang telah dinarasikan.

Dokumentasi

Server MCP 2slides

2slides

Ekspos alat 2slides.com untuk klien MCP (misalnya, Claude Desktop).

Dapatkan Kunci API Anda

Sebelum menggunakan server MCP ini, Anda perlu mendapatkan kunci API dari 2slides.com/api.

Konfigurasi di Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json dan tambahkan:

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

Kemudian mulai ulang sepenuhnya Claude Desktop. Dalam obrolan, buka panel alat dan Anda akan melihat alat di bawah ini.

Alat yang Tersedia

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

Hasilkan presentasi PowerPoint menggunakan tema bawaan (Fast PPT). Gunakan themes_search terlebih dahulu untuk menemukan themeId.

  • Argumen:
    • userInput (string, wajib) — konten presentasi
    • themeId (string, wajib) — ID tema dari themes_search
    • responseLanguage (string, opsional, default: Auto) — bahasa keluaran; nilai yang didukung: Auto, English, Spanish, Arabic, Portuguese, Indonesian, Japanese, Russian, Hindi, French, German, Greek, Vietnamese, Turkish, Thai, Polish, Italian, Korean, Simplified Chinese, Traditional Chinese
    • mode (opsional, default: sync) — sync mengembalikan downloadUrl segera; async mengembalikan jobId untuk dipolling dengan jobs_get
  • Kredit: 1 per halaman
  • Contoh: 
    {
  "themeId": "st-1756528793701-fcg5fblt2",
  "userInput": "Generate a 5-slide intro to machine learning",
  "responseLanguage": "English",
  "mode": "sync"
}

themes_search (GET /api/v1/themes/search)

Cari tema bawaan untuk digunakan dengan slides_generate.

  • Argumen:
    • query (string, wajib) — kata kunci pencarian (mis. business, minimal, dark)
    • limit (angka, opsional, default: 10, rentang: 1–100)
  • Mengembalikan: array tema dengan id, name, description, previewUrl, tags
  • Kredit: gratis
  • Contoh: 
    { "query": "business", "limit": 5 }

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

Polling status pekerjaan dan ambil hasilnya saat siap.

  • Argumen:
    • jobId (string, wajib)
  • Mengembalikan: jobId, status (pending / processing / success / failed), message, downloadUrl (saat berhasil), slidePageCount, createdAt, updatedAt, duration (ms), jobUrl (hanya pekerjaan Nano Banana)
  • Kredit: gratis
  • Catatan: Polling setiap 20 detik hingga status adalah success atau failed.
  • Contoh: 
    { "jobId": "D8h9VYDGdTlZ6wWSEoctF" }

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

Hasilkan slide (Nano Banana) yang cocok dengan gaya gambar referensi.

  • Argumen:
    • userInput (string, wajib) — konten presentasi
    • referenceImageUrl (string, wajib) — URL gambar referensi gaya
    • responseLanguage (string, opsional, default: Auto)
    • aspectRatio (string, opsional, default: 16:9) — nilai yang valid: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
    • resolution (string, opsional, default: 2K) — 1K, 2K, 4K
    • page (angka, opsional, default: 0) — 0 = deteksi otomatis, 1–100 = jumlah halaman tepat
    • contentDetail (string, opsional, default: standard) — concise atau standard
    • mode (string, opsional, default: async) — async mengembalikan jobId; sync mengembalikan downloadUrl segera
  • Kredit: 100 per halaman (1K/2K) atau 200 per halaman (4K)
  • Contoh: 
    {
  "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)

Hasilkan slide dengan desain kustom (Nano Banana) dari konten teks tanpa gambar referensi.

  • Argumen:
    • userInput (string, wajib) — konten presentasi
    • designStyle (string, opsional) — deskripsi teks bebas dari gaya visual; kosongkan untuk gaya default
    • responseLanguage (string, opsional, default: Auto)
    • aspectRatio (string, opsional, default: 16:9) — nilai yang valid: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
    • resolution (string, opsional, default: 2K) — 1K, 2K, 4K
    • page (angka, opsional, default: 0) — 0 = deteksi otomatis, 1–100 = jumlah halaman tepat
    • contentDetail (string, opsional, default: standard) — concise atau standard
    • mode (string, opsional, default: async) — async mengembalikan jobId; sync mengembalikan downloadUrl segera
  • Kredit: 100 per halaman (1K/2K) atau 200 per halaman (4K)
  • Contoh: 
    {
  "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)

Tambahkan narasi suara AI ke pekerjaan Nano Banana yang telah selesai (hanya slides_create_like_this atau slides_create_pdf_slides; Fast PPT tidak didukung). Selalu async — polling hasilnya dengan jobs_get.

  • Argumen (satu pembicara, default mode: "single"):

    • jobId (string, wajib) — UUID dari pekerjaan Nano Banana yang telah selesai
    • mode (string, opsional, default: single) — single atau multi
    • speakerName (string, opsional) — nama narator
    • voice (string, opsional) — salah satu dari 30 suara (lihat daftar di bawah)
    • contentMode (string, opsional, default: standard) — concise atau standard
    • includeIntro (boolean, opsional, default: true)

  • Argumen (dua pembicara, mode: "multi"):

    • jobId (string, wajib)
    • mode (string, wajib) — multi
    • speaker1Name (string, wajib)
    • speaker2Name (string, wajib)
    • speaker1Voice (string, opsional) — suara untuk pembicara 1
    • speaker2Voice (string, opsional) — suara untuk pembicara 2
    • contentMode (string, opsional, default: standard) — concise atau standard

  • Suara yang didukung (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

  • Kredit: 210 per halaman (10 teks + 200 audio)

  • Contoh:

    {
  "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)

Ekspor halaman slide dan narasi audio sebagai file ZIP. Pekerjaan harus selesai dan memiliki narasi yang dihasilkan.

  • Argumen:
    • jobId (string, wajib) — UUID dari pekerjaan dengan narasi yang telah selesai
  • Mengembalikan: downloadUrl (kedaluwarsa dalam 1 jam), fileName, expiresIn (3600 detik)
  • Isi ZIP: 
    pages/
  page_01.png, page_02.png, …
voices/
  page_01.wav, page_02.wav, …
transcript.txt
  • Kredit: gratis
  • Contoh: 
    { "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" }

Alur Kerja Umum

Fast PPT (PowerPoint berbasis tema):

  1. themes_search → dapatkan themeId
  2. slides_generate (sync) → dapatkan downloadUrl langsung

Nano Banana (slide dengan desain kustom):

  1. slides_create_like_this atau slides_create_pdf_slides (async) → dapatkan jobId
  2. jobs_get (polling setiap 20 detik) → dapatkan downloadUrl saat status: "success"

Nano Banana dengan narasi:

  1. slides_create_like_this atau slides_create_pdf_slides → dapatkan jobId
  2. jobs_get → tunggu slide selesai
  3. slides_generate_narration → dapatkan jobId narasi
  4. jobs_get → tunggu narasi selesai
  5. slides_download_pages_voices → dapatkan tautan unduh ZIP

Pemecahan Masalah (Claude Desktop)

  • Jika alat tidak muncul di Claude, verifikasi bahwa jalur konfigurasi absolut dan mulai ulang aplikasi.
  • Periksa log Claude MCP:
tail -n 50 -f ~/Library/Logs/Claude/mcp*.log
  • Untuk server MCP stdio, hindari logging ke stdout; server ini hanya mencatat kesalahan ke stderr.

Referensi