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)

पूर्व-निर्मित थीम (Fast PPT) का उपयोग करके एक PowerPoint प्रस्तुति तैयार करें। themeId खोजने के लिए पहले themes_search का उपयोग करें।

• तर्क:
  • 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 jobs_get के साथ मतदान करने के लिए jobId लौटाता है
• क्रेडिट: प्रति पृष्ठ 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 (ms), 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 वॉइस नैरेशन जोड़ें। हमेशा async — 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" }
  

---

विशिष्ट कार्यप्रवाह

Fast PPT (थीम-आधारित PowerPoint):

1. themes_search → themeId प्राप्त करें
2. slides_generate (sync) → सीधे downloadUrl प्राप्त करें

Nano Banana (कस्टम-डिज़ाइन की गई स्लाइड):

1. slides_create_like_this या slides_create_pdf_slides (async) → jobId प्राप्त करें
2. jobs_get (हर 20 सेकंड में मतदान) → downloadUrl प्राप्त करें जब status: "success"

नैरेशन के साथ 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