ElevenLabs

[!WARNING] यह स्थानीय MCP सर्वर ElevenLabs होस्टेड MCP सर्वर के पक्ष में हटाया जा रहा है।

होस्टेड सर्वर https://api.elevenlabs.io/v1/mcp पर उपलब्ध है, जिसमें स्थानीय रूप से कुछ भी इंस्टॉल या चलाने की आवश्यकता नहीं है। यह OAuth के साथ प्रमाणित होता है, इसलिए आपके क्लाइंट में कोई API कुंजी कॉपी नहीं की जाती है। Claude, Cursor, या किसी अन्य MCP क्लाइंट से कनेक्ट करने के लिए होस्टेड MCP सर्वर दस्तावेज़ देखें।

यह रिपॉजिटरी अब सक्रिय रूप से अनुरक्षित नहीं है।

आधिकारिक ElevenLabs Model Context Protocol (MCP) सर्वर जो शक्तिशाली टेक्स्ट-टू-स्पीच और ऑडियो प्रोसेसिंग API के साथ इंटरैक्शन सक्षम करता है। यह सर्वर 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 रिपो देखें।
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 एजेंट बनाएं जो फिल्म नोयर जासूस की तरह बोलता है और क्लासिक फिल्मों के बारे में सवालों के जवाब दे सकता है"
• "एक बुद्धिमान, प्राचीन ड्रैगन चरित्र के लिए तीन आवाज़ विविधताएं उत्पन्न करें, फिर मैं अपनी आवाज़ लाइब्रेरी में जोड़ने के लिए अपनी पसंदीदा आवाज़ चुनूंगा"
• "मेरी आवाज़ की इस रिकॉर्डिंग को मध्ययुगीन शूरवीर की तरह सुनने के लिए परिवर्तित करें"
• "घने जंगल में गरज के साथ बारिश का ध्वनि दृश्य बनाएं जिसमें जानवर मौसम पर प्रतिक्रिया कर रहे हों"
• "इस भाषण को पाठ में बदलें, विभिन्न वक्ताओं की पहचान करें, फिर प्रत्येक व्यक्ति के लिए अद्वितीय आवाज़ों का उपयोग करके इसे वापस परिवर्तित करें"

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

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

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

• 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")। यह सुनिश्चित करता है कि सही निष्पादन योग्य संदर्भित है।