ElevenLabs

[!WARNING] Bu yerel MCP sunucusu, ElevenLabs barındırılan MCP sunucusu lehine kullanımdan kaldırılmıştır.

Barındırılan sunucu https://api.elevenlabs.io/v1/mcp adresinde mevcuttur; yerel olarak kurulacak veya çalıştırılacak bir şey yoktur. OAuth ile kimlik doğrulaması yapar, böylece istemcinize API anahtarları kopyalanmaz. Claude, Cursor veya başka bir MCP istemcisinden bağlanmak için barındırılan MCP sunucusu belgelerine bakın.

Bu depo artık aktif olarak bakımı yapılmamaktadır.

Güçlü Metin Okuma ve ses işleme API'leriyle etkileşimi sağlayan resmi ElevenLabs Model Context Protocol (MCP) sunucusu. Bu sunucu, Claude Desktop, Cursor, Windsurf, OpenAI Agents gibi MCP istemcilerinin ve diğerlerinin ses üretmesine, ses klonlamasına, ses transkripsiyonu yapmasına ve daha fazlasına olanak tanır.

Claude Desktop ile Hızlı Başlangıç

1. API anahtarınızı ElevenLabs adresinden alın. Ayda 10 bin kredi içeren ücretsiz bir katman mevcuttur.
2. uv (Python paket yöneticisi) kurun, curl -LsSf https://astral.sh/uv/install.sh | sh ile kurun veya ek kurulum yöntemleri için uv deposuna bakın.
3. Claude > Ayarlar > Geliştirici > Yapılandırmayı Düzenle > claude_desktop_config.json bölümüne gidip aşağıdakileri ekleyin:

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

Windows kullanıyorsanız, MCP sunucusunu kullanmak için Claude Desktop'ta "Geliştirici Modu"nu etkinleştirmeniz gerekecektir. Sol üstteki hamburger menüsünde "Yardım"a tıklayın ve "Geliştirici Modunu Etkinleştir"i seçin.

Diğer MCP istemcileri

Cursor ve Windsurf gibi diğer istemciler için şunları çalıştırın:

1. pip install elevenlabs-mcp
2. Yapılandırmayı almak için python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print. MCP istemcinizin belirttiği uygun yapılandırma dizinine yapıştırın.

Bu kadar. MCP istemciniz artık ElevenLabs ile şu araçlar aracılığıyla etkileşim kurabilir:

Örnek kullanım

⚠️ Uyarı: Bu araçları kullanmak için ElevenLabs kredileri gereklidir.

Claude'a şunları sormayı deneyin:

• "Kara film dedektifi gibi konuşan ve klasik filmler hakkında soruları yanıtlayabilen bir yapay zeka ajanı oluştur"
• "Bilge, kadim bir ejderha karakteri için üç ses varyasyonu üret, sonra ses kütüphaneme eklemek için favori sesimi seçeceğim"
• "Sesimin bu kaydını ortaçağ şövalyesi gibi ses çıkaracak şekilde dönüştür"
• "Yoğun bir ormanda hayvanların hava durumuna tepki verdiği bir gök gürültülü fırtına ses manzarası oluştur"
• "Bu konuşmayı metne dönüştür, farklı konuşmacıları tanımla, ardından her kişi için benzersiz sesler kullanarak tekrar dönüştür"

İsteğe bağlı özellikler

Dosya Çıktı Yapılandırması

MCP sunucusunun dosya çıktılarını nasıl işlediğini, claude_desktop_config.json içindeki şu ortam değişkenlerini kullanarak yapılandırabilirsiniz:

• ELEVENLABS_MCP_BASE_PATH: Dosya işlemleri için temel yolu belirtin (varsayılan: ~/Desktop). Bu dizin aynı zamanda giriş dosyaları için güvenlik sınırıdır: yerel bir dosyayı okuyan bir araca iletilen herhangi bir yol (örn. speech_to_text, isolate_audio, speech_to_speech, video_to_music, upload_music_for_inpainting), mutlak veya göreli yol olarak verilmiş olsun, bu dizinin içinde çözümlenmelidir. Dışındaki yollar — mutlak olsa ve daha önce kabul edilmiş olsa bile — reddedilir. Bunu, okumanız veya yazmanız gereken her şeyi içeren bir dizine ayarlayın.
• ELEVENLABS_MCP_OUTPUT_MODE: Oluşturulan dosyaların nasıl döndürüleceğini kontrol edin (varsayılan: files)

Çıktı Modları

ELEVENLABS_MCP_OUTPUT_MODE ortam değişkeni üç modu destekler:

1. files (varsayılan): Dosyaları diske kaydedin ve dosya yollarını döndürün

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

2. resources: Dosyaları MCP kaynakları olarak döndürün; ikili veriler base64 kodlu, metin UTF-8 metin olarak döndürülür

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

3. both: Dosyaları diske kaydedin VE MCP kaynakları olarak döndürün

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

Kaynak Modu Avantajları:

• Dosyalar, MCP yanıtında doğrudan base64 kodlu veri olarak döndürülür
• Disk G/Ç gerektirmez - konteynerleştirilmiş veya sunucusuz ortamlar için kullanışlıdır
• MCP istemcileri, dosya sistemi erişimi olmadan dosya içeriğine anında erişebilir
• both modunda, kaynaklar daha sonra elevenlabs://filename URI deseni kullanılarak getirilebilir

Kullanım Durumları:

• files: Geleneksel dosya tabanlı iş akışları, yerel geliştirme
• resources: Bulut ortamları, dosya sistemi erişimi olmayan MCP istemcileri
• both: Maksimum esneklik, önbelleğe alma ve kaynak paylaşım senaryoları

Veri yerleşimi anahtarları

Veri yerleşimi bölgesini ELEVENLABS_API_RESIDENCY ortam değişkeniyle belirtebilirsiniz. Varsayılan "us" değerindedir.

Not: Veri yerleşimi yalnızca kurumsal bir özelliktir. Daha fazla ayrıntı için belgelere bakın.

Katkıda bulunma

Katkıda bulunmak veya kaynaktan çalıştırmak istiyorsanız:

1. Depoyu klonlayın:

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

2. Sanal bir ortam oluşturun ve uv kullanarak bağımlılıkları kurun:

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

3. .env.example dosyasını .env olarak kopyalayın ve ElevenLabs API anahtarınızı ekleyin:

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

4. Her şeyin çalıştığından emin olmak için testleri çalıştırın:

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

5. Sunucuyu Claude Desktop'a kurun: mcp install elevenlabs_mcp/server.py

6. MCP Inspector ile yerel olarak hata ayıklayın ve test edin: mcp dev elevenlabs_mcp/server.py

Sorun giderme

Claude Desktop ile çalışırken günlükler şurada bulunabilir:

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

Belirli araçları kullanırken zaman aşımları

Ses tasarımı ve ses izolasyonu gibi bazı ElevenLabs API işlemleri çözümlenmesi uzun sürebilir. Geliştirme modunda MCP inspector kullanırken, araç amaçlanan görevini tamamlamış olsa bile zaman aşımı hataları alabilirsiniz.

Bu, Claude gibi bir istemci kullanırken oluşmamalıdır.

MCP ElevenLabs: spawn uvx ENOENT

"MCP ElevenLabs: spawn uvx ENOENT" hatasıyla karşılaşırsanız, terminalinizde şu komutu çalıştırarak mutlak yolunu doğrulayın:

which uvx

Mutlak yolu elde ettiğinizde (örn. /usr/local/bin/uvx), yapılandırmanızı bu yolu kullanacak şekilde güncelleyin (örn. "command": "/usr/local/bin/uvx"). Bu, doğru yürütülebilir dosyanın referans alınmasını sağlar.