ElevenLabs

[!WARNING] Server MCP lokal ini tidak digunakan lagi dan digantikan oleh server MCP ElevenLabs yang di-hosting.

Server yang di-hosting tersedia di https://api.elevenlabs.io/v1/mcp, tanpa perlu menginstal atau menjalankan apa pun secara lokal. Server ini melakukan autentikasi dengan OAuth, sehingga tidak ada kunci API yang disalin ke klien Anda. Lihat dokumentasi server MCP yang di-hosting untuk terhubung dari Claude, Cursor, atau klien MCP lainnya.

Repositori ini tidak lagi dikelola secara aktif.

Server Model Context Protocol (MCP) resmi ElevenLabs yang memungkinkan interaksi dengan API Text to Speech dan pemrosesan audio yang canggih. Server ini memungkinkan klien MCP seperti Claude Desktop, Cursor, Windsurf, OpenAI Agents, dan lainnya untuk menghasilkan ucapan, mengkloning suara, mentranskripsikan audio, dan banyak lagi.

Memulai dengan cepat menggunakan Claude Desktop

1. Dapatkan kunci API Anda dari ElevenLabs. Ada paket gratis dengan 10 ribu kredit per bulan.
2. Instal uv (pengelola paket Python), instal dengan curl -LsSf https://astral.sh/uv/install.sh | sh atau lihat uv repositori untuk metode instalasi tambahan.
3. Buka Claude > Settings > Developer > Edit Config > claude_desktop_config.json untuk menyertakan hal berikut:

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

Jika Anda menggunakan Windows, Anda harus mengaktifkan "Developer Mode" di Claude Desktop untuk menggunakan server MCP. Klik "Help" di menu hamburger di kiri atas dan pilih "Enable Developer Mode".

Klien MCP lainnya

Untuk klien lain seperti Cursor dan Windsurf, jalankan:

1. pip install elevenlabs-mcp
2. python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print untuk mendapatkan konfigurasi. Tempelkan ke direktori konfigurasi yang sesuai yang ditentukan oleh klien MCP Anda.

Itu saja. Klien MCP Anda sekarang dapat berinteraksi dengan ElevenLabs melalui alat-alat berikut:

Contoh penggunaan

⚠️ Peringatan: Kredit ElevenLabs diperlukan untuk menggunakan alat-alat ini.

Coba tanyakan pada Claude:

• "Buat agen AI yang berbicara seperti detektif film noir dan dapat menjawab pertanyaan tentang film klasik"
• "Hasilkan tiga variasi suara untuk karakter naga kuno yang bijaksana, lalu saya akan memilih suara favorit saya untuk ditambahkan ke pustaka suara saya"
• "Ubah rekaman suara saya ini agar terdengar seperti ksatria abad pertengahan"
• "Buat lanskap suara badai petir di hutan lebat dengan hewan yang bereaksi terhadap cuaca"
• "Ubah ucapan ini menjadi teks, identifikasi pembicara yang berbeda, lalu ubah kembali menggunakan suara unik untuk setiap orang"

Fitur opsional

Konfigurasi Output File

Anda dapat mengonfigurasi cara server MCP menangani output file menggunakan variabel lingkungan berikut di claude_desktop_config.json Anda:

• ELEVENLABS_MCP_BASE_PATH: Tentukan jalur dasar untuk operasi file (default: ~/Desktop). Direktori ini juga merupakan batas keamanan untuk file input: jalur apa pun yang diteruskan ke alat yang membaca file lokal (misalnya speech_to_text, isolate_audio, speech_to_speech, video_to_music, upload_music_for_inpainting) harus diselesaikan di dalam direktori ini, baik diberikan sebagai jalur absolut maupun relatif. Jalur di luarnya — bahkan jika absolut dan sebelumnya diterima — akan ditolak. Atur ini ke direktori yang berisi semua yang perlu Anda baca atau tulis.
• ELEVENLABS_MCP_OUTPUT_MODE: Kontrol bagaimana file yang dihasilkan dikembalikan (default: files)

Mode Output

Variabel lingkungan ELEVENLABS_MCP_OUTPUT_MODE mendukung tiga mode:

1. files (default): Simpan file ke disk dan kembalikan jalur file

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

2. resources: Kembalikan file sebagai sumber daya MCP; data biner dienkode base64, teks dikembalikan sebagai teks UTF-8

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

3. both: Simpan file ke disk DAN kembalikan sebagai sumber daya MCP

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

Manfaat Mode Sumber Daya:

• File dikembalikan langsung dalam respons MCP sebagai data berenkode base64
• Tidak diperlukan I/O disk - berguna untuk lingkungan kontainer atau serverless
• Klien MCP dapat mengakses konten file segera tanpa akses sistem file
• Dalam mode both, sumber daya dapat diambil nanti menggunakan pola URI elevenlabs://filename

Kasus Penggunaan:

• files: Alur kerja berbasis file tradisional, pengembangan lokal
• resources: Lingkungan cloud, klien MCP tanpa akses sistem file
• both: Fleksibilitas maksimum, caching, dan skenario berbagi sumber daya

Kunci residensi data

Anda dapat menentukan wilayah residensi data dengan variabel lingkungan ELEVENLABS_API_RESIDENCY. Defaultnya adalah "us".

Catatan: Residensi data adalah fitur khusus enterprise. Lihat dokumentasi untuk detail lebih lanjut.

Berkontribusi

Jika Anda ingin berkontribusi atau menjalankan dari sumber:

1. Klon repositori:

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

2. Buat lingkungan virtual dan instal dependensi menggunakan uv:

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

3. Salin .env.example ke .env dan tambahkan kunci API ElevenLabs Anda:

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

4. Jalankan pengujian untuk memastikan semuanya berfungsi:

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

5. Instal server di Claude Desktop: mcp install elevenlabs_mcp/server.py

6. Debug dan uji secara lokal dengan MCP Inspector: mcp dev elevenlabs_mcp/server.py

Pemecahan Masalah

Log saat menjalankan dengan Claude Desktop dapat ditemukan di:

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

Timeout saat menggunakan alat tertentu

Operasi API ElevenLabs tertentu, seperti desain suara dan isolasi audio, dapat memakan waktu lama untuk diselesaikan. Saat menggunakan inspector MCP dalam mode dev, Anda mungkin mendapatkan kesalahan timeout meskipun alat telah menyelesaikan tugas yang dimaksudkan.

Ini seharusnya tidak terjadi saat menggunakan klien seperti Claude.

MCP ElevenLabs: spawn uvx ENOENT

Jika Anda mengalami kesalahan "MCP ElevenLabs: spawn uvx ENOENT", konfirmasikan jalur absolutnya dengan menjalankan perintah ini di terminal Anda:

which uvx

Setelah Anda mendapatkan jalur absolut (misalnya, /usr/local/bin/uvx), perbarui konfigurasi Anda untuk menggunakan jalur tersebut (misalnya, "command": "/usr/local/bin/uvx"). Ini memastikan bahwa executable yang benar direferensikan.