ElevenLabs

आधिकारिक ElevenLabs Model Context Protocol (MCP) सर्वर जो शक्तिशाली Text to Speech और ऑडियो प्रोसेसिंग APIs के साथ इंटरैक्शन सक्षम बनाता है। यह सर्वर MCP क्लाइंट जैसे Claude Desktop, Cursor, Windsurf, OpenAI Agents और अन्य को स्पीच जनरेट करने, आवाज़ें क्लोन करने, ऑडियो ट्रांसक्राइब करने और अधिक करने की अनुमति देता है।

Claude Desktop के साथ त्वरित प्रारंभ

1. ElevenLabs से अपनी API कुंजी प्राप्त करें। प्रति माह 10k क्रेडिट के साथ एक निःशुल्क टियर उपलब्ध है।
2. uv (Python पैकेज मैनेजर) स्थापित करें, curl -LsSf https://astral.sh/uv/install.sh | sh के साथ स्थापित करें या अतिरिक्त स्थापना विधियों के लिए uv repo देखें।
3. Claude > Settings > Developer > Edit Config > claude_desktop_config.json पर जाकर निम्नलिखित शामिल करें:

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "uvx",
      "args": ["elevenlabs-mcp"],
      "env": {
        "ELEVENLABS_API_KEY": "<insert-your-api-key-here>"
      }
    }
  }
}

यदि आप Windows का उपयोग कर रहे हैं, तो MCP सर्वर का उपयोग करने के लिए आपको Claude Desktop में "Developer Mode" सक्षम करना होगा। ऊपर बाएँ हैमबर्गर मेनू में "Help" पर क्लिक करें और "Enable Developer Mode" चुनें।

अन्य MCP क्लाइंट

Cursor और Windsurf जैसे अन्य क्लाइंट के लिए, निम्नलिखित चलाएँ:

1. pip install elevenlabs-mcp
2. python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print कॉन्फ़िगरेशन प्राप्त करने के लिए। इसे अपने MCP क्लाइंट द्वारा निर्दिष्ट उपयुक्त कॉन्फ़िगरेशन निर्देशिका में पेस्ट करें।

बस इतना ही। आपका MCP क्लाइंट अब इन टूल के माध्यम से ElevenLabs के साथ इंटरैक्ट कर सकता है:

उपयोग उदाहरण

⚠️ चेतावनी: इन टूल का उपयोग करने के लिए ElevenLabs क्रेडिट आवश्यक हैं।

Claude से पूछने का प्रयास करें:

• "एक AI एजेंट बनाएं जो फिल्म नोयर जासूस की तरह बोलता है और क्लासिक फिल्मों के बारे में सवालों के जवाब दे सकता है"
• "एक बुद्धिमान, प्राचीन ड्रैगन चरित्र के लिए तीन आवाज़ विविधताएं उत्पन्न करें, फिर मैं अपनी आवाज़ लाइब्रेरी में जोड़ने के लिए अपनी पसंदीदा आवाज़ चुनूंगा"
• "मेरी आवाज़ की यह रिकॉर्डिंग मध्ययुगीन शूरवीर की तरह सुनाई देने के लिए बदलें"
• "घने जंगल में गरज के साथ बारिश का साउंडस्केप बनाएं, जिसमें जानवर मौसम पर प्रतिक्रिया कर रहे हों"
• "इस भाषण को टेक्स्ट में बदलें, विभिन्न वक्ताओं की पहचान करें, फिर प्रत्येक व्यक्ति के लिए अद्वितीय आवाज़ों का उपयोग करके इसे वापस बदलें"

वैकल्पिक सुविधाएँ

फ़ाइल आउटपुट कॉन्फ़िगरेशन

आप अपने claude_desktop_config.json में इन पर्यावरण चरों का उपयोग करके MCP सर्वर फ़ाइल आउटपुट को कैसे संभालता है, इसे कॉन्फ़िगर कर सकते हैं:

• ELEVENLABS_MCP_BASE_PATH: फ़ाइल संचालन के लिए आधार पथ निर्दिष्ट करें (डिफ़ॉल्ट: ~/Desktop)। यह निर्देशिका इनपुट फ़ाइलों के लिए भी सुरक्षा सीमा है: किसी टूल को दिया गया कोई भी पथ जो स्थानीय फ़ाइल पढ़ता है (जैसे speech_to_text, isolate_audio, speech_to_speech, video_to_music, upload_music_for_inpainting) इस निर्देशिका के अंदर हल होना चाहिए, चाहे वह निरपेक्ष या सापेक्ष पथ के रूप में दिया गया हो। इसके बाहर के पथ—भले ही वे निरपेक्ष हों और पहले स्वीकार किए गए हों—अस्वीकार कर दिए जाते हैं। इसे एक ऐसी निर्देशिका पर सेट करें जिसमें वह सब कुछ हो जो आपको पढ़ने या लिखने की आवश्यकता है।
• ELEVENLABS_MCP_OUTPUT_MODE: नियंत्रित करें कि उत्पन्न फ़ाइलें कैसे लौटाई जाती हैं (डिफ़ॉल्ट: files)

आउटपुट मोड

ELEVENLABS_MCP_OUTPUT_MODE पर्यावरण चर तीन मोड का समर्थन करता है:

1. files (डिफ़ॉल्ट): फ़ाइलों को डिस्क पर सहेजें और फ़ाइल पथ लौटाएँ

   "env": {
     "ELEVENLABS_API_KEY": "your-api-key",
     "ELEVENLABS_MCP_OUTPUT_MODE": "files"
   }
   

2. resources: फ़ाइलों को MCP संसाधनों के रूप में लौटाएँ; बाइनरी डेटा base64-एन्कोडेड है, टेक्स्ट UTF-8 टेक्स्ट के रूप में लौटाया जाता है

   "env": {
     "ELEVENLABS_API_KEY": "your-api-key",
     "ELEVENLABS_MCP_OUTPUT_MODE": "resources"
   }
   

3. both: फ़ाइलों को डिस्क पर सहेजें और MCP संसाधनों के रूप में भी लौटाएँ

   "env": {
     "ELEVENLABS_API_KEY": "your-api-key",
     "ELEVENLABS_MCP_OUTPUT_MODE": "both"
   }
   

संसाधन मोड के लाभ:

• फ़ाइलें सीधे MCP प्रतिक्रिया में base64-एन्कोडेड डेटा के रूप में लौटाई जाती हैं
• कोई डिस्क I/O आवश्यक नहीं - कंटेनरीकृत या सर्वरलेस वातावरण के लिए उपयोगी
• MCP क्लाइंट बिना फ़ाइल सिस्टम एक्सेस के तुरंत फ़ाइल सामग्री तक पहुँच सकते हैं
• both मोड में, संसाधनों को बाद में elevenlabs://filename URI पैटर्न का उपयोग करके प्राप्त किया जा सकता है

उपयोग के मामले:

• files: पारंपरिक फ़ाइल-आधारित कार्यप्रवाह, स्थानीय विकास
• resources: क्लाउड वातावरण, बिना फ़ाइल सिस्टम एक्सेस वाले MCP क्लाइंट
• both: अधिकतम लचीलापन, कैशिंग, और संसाधन साझाकरण परिदृश्य

डेटा निवास कुंजियाँ

आप ELEVENLABS_API_RESIDENCY पर्यावरण चर के साथ डेटा निवास क्षेत्र निर्दिष्ट कर सकते हैं। डिफ़ॉल्ट: "us"।

नोट: डेटा निवास केवल एंटरप्राइज़ सुविधा है। अधिक विवरण के लिए दस्तावेज़ देखें।

योगदान

यदि आप योगदान देना चाहते हैं या स्रोत से चलाना चाहते हैं:

1. रिपॉजिटरी क्लोन करें:

git clone https://github.com/elevenlabs/elevenlabs-mcp
cd elevenlabs-mcp

2. एक वर्चुअल वातावरण बनाएं और uv का उपयोग करके निर्भरताएँ स्थापित करें:

uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"

3. .env.example को .env में कॉपी करें और अपनी ElevenLabs API कुंजी जोड़ें:

cp .env.example .env
# Edit .env and add your API key

4. यह सुनिश्चित करने के लिए परीक्षण चलाएँ कि सब कुछ काम कर रहा है:

./scripts/test.sh
# Or with options
./scripts/test.sh --verbose --fail-fast

5. सर्वर को Claude Desktop में स्थापित करें: mcp install elevenlabs_mcp/server.py

6. MCP Inspector के साथ स्थानीय रूप से डीबग और परीक्षण करें: mcp dev elevenlabs_mcp/server.py

समस्या निवारण

Claude Desktop के साथ चलते समय लॉग यहाँ पाए जा सकते हैं:

• Windows: %APPDATA%\Claude\logs\mcp-server-elevenlabs.log
• macOS: ~/Library/Logs/Claude/mcp-server-elevenlabs.log

कुछ टूल का उपयोग करते समय टाइमआउट

कुछ ElevenLabs API ऑपरेशन, जैसे वॉयस डिज़ाइन और ऑडियो आइसोलेशन, को हल होने में लंबा समय लग सकता है। जब आप डेव मोड में MCP इंस्पेक्टर का उपयोग कर रहे हैं, तो टूल अपना इच्छित कार्य पूरा करने के बावजूद टाइमआउट त्रुटियाँ मिल सकती हैं।

Claude जैसे क्लाइंट का उपयोग करते समय ऐसा नहीं होना चाहिए।

MCP ElevenLabs: spawn uvx ENOENT

यदि आपको "MCP ElevenLabs: spawn uvx ENOENT" त्रुटि का सामना करना पड़ता है, तो अपने टर्मिनल में निम्न कमांड चलाकर इसका निरपेक्ष पथ सत्यापित करें:

which uvx

एक बार जब आप निरपेक्ष पथ प्राप्त कर लें (जैसे, /usr/local/bin/uvx), तो उस पथ का उपयोग करने के लिए अपने कॉन्फ़िगरेशन को अपडेट करें (जैसे, "command": "/usr/local/bin/uvx")। यह सुनिश्चित करता है कि सही निष्पादन योग्य संदर्भित किया गया है।