ElevenLabs

[!WARNING] Este servidor MCP local está obsoleto en favor del servidor MCP alojado de ElevenLabs.

El servidor alojado está disponible en https://api.elevenlabs.io/v1/mcp, sin necesidad de instalar o ejecutar nada localmente. Se autentica con OAuth, por lo que no se copian claves API en tu cliente. Consulta la documentación del servidor MCP alojado para conectarte desde Claude, Cursor o cualquier otro cliente MCP.

Este repositorio ya no se mantiene activamente.

Servidor oficial de ElevenLabs Model Context Protocol (MCP) que permite la interacción con potentes APIs de texto a voz y procesamiento de audio. Este servidor permite que clientes MCP como Claude Desktop, Cursor, Windsurf, OpenAI Agents y otros generen voz, clonen voces, transcriban audio y más.

Inicio rápido con Claude Desktop

1. Obtén tu clave API en ElevenLabs. Hay un nivel gratuito con 10k créditos al mes.
2. Instala uv (gestor de paquetes de Python), instala con curl -LsSf https://astral.sh/uv/install.sh | sh o consulta el uv repositorio para métodos de instalación adicionales.
3. Ve a Claude > Configuración > Desarrollador > Editar configuración > claude_desktop_config.json para incluir lo siguiente:

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

Si usas Windows, tendrás que habilitar el "Modo Desarrollador" en Claude Desktop para usar el servidor MCP. Haz clic en "Ayuda" en el menú de hamburguesa en la parte superior izquierda y selecciona "Habilitar Modo Desarrollador".

Otros clientes MCP

Para otros clientes como Cursor y Windsurf, ejecuta:

1. pip install elevenlabs-mcp
2. python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print para obtener la configuración. Pégala en el directorio de configuración apropiado especificado por tu cliente MCP.

Eso es todo. Tu cliente MCP ahora puede interactuar con ElevenLabs a través de estas herramientas:

Ejemplo de uso

⚠️ Advertencia: Se necesitan créditos de ElevenLabs para usar estas herramientas.

Prueba preguntando a Claude:

• "Crea un agente de IA que hable como un detective de cine negro y pueda responder preguntas sobre películas clásicas"
• "Genera tres variaciones de voz para un personaje de dragón antiguo y sabio, luego elegiré mi voz favorita para añadirla a mi biblioteca de voces"
• "Convierte esta grabación de mi voz para que suene como un caballero medieval"
• "Crea un paisaje sonoro de una tormenta en una jungla densa con animales reaccionando al clima"
• "Convierte este discurso en texto, identifica a diferentes hablantes, luego conviértelo de nuevo usando voces únicas para cada persona"

Características opcionales

Configuración de salida de archivos

Puedes configurar cómo el servidor MCP maneja las salidas de archivos usando estas variables de entorno en tu claude_desktop_config.json:

• ELEVENLABS_MCP_BASE_PATH: Especifica la ruta base para las operaciones de archivos (predeterminado: ~/Desktop). Este directorio también es el límite de seguridad para archivos de entrada: cualquier ruta pasada a una herramienta que lea un archivo local (por ejemplo, speech_to_text, isolate_audio, speech_to_speech, video_to_music, upload_music_for_inpainting) debe resolverse dentro de este directorio, ya sea dada como ruta absoluta o relativa. Las rutas fuera de él — incluso si son absolutas y previamente aceptadas — son rechazadas. Establece esto a un directorio que contenga todo lo que necesitas leer o escribir.
• ELEVENLABS_MCP_OUTPUT_MODE: Controla cómo se devuelven los archivos generados (predeterminado: files)

Modos de salida

La variable de entorno ELEVENLABS_MCP_OUTPUT_MODE admite tres modos:

1. files (predeterminado): Guarda archivos en disco y devuelve rutas de archivo

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

2. resources: Devuelve archivos como recursos MCP; los datos binarios se codifican en base64, el texto se devuelve como texto UTF-8

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

3. both: Guarda archivos en disco Y los devuelve como recursos MCP

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

Beneficios del modo recurso:

• Los archivos se devuelven directamente en la respuesta MCP como datos codificados en base64
• No se requiere E/S de disco - útil para entornos contenedorizados o sin servidor
• Los clientes MCP pueden acceder al contenido del archivo inmediatamente sin acceso al sistema de archivos
• En modo both, los recursos se pueden recuperar más tarde usando el patrón URI elevenlabs://filename

Casos de uso:

• files: Flujos de trabajo tradicionales basados en archivos, desarrollo local
• resources: Entornos en la nube, clientes MCP sin acceso al sistema de archivos
• both: Máxima flexibilidad, almacenamiento en caché y escenarios de intercambio de recursos

Claves de residencia de datos

Puedes especificar la región de residencia de datos con la variable de entorno ELEVENLABS_API_RESIDENCY. El valor predeterminado es "us".

Nota: La residencia de datos es una característica solo para empresas. Consulta la documentación para más detalles.

Contribuir

Si quieres contribuir o ejecutar desde el código fuente:

1. Clona el repositorio:

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

2. Crea un entorno virtual e instala las dependencias usando uv:

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

3. Copia .env.example a .env y añade tu clave API de ElevenLabs:

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

4. Ejecuta las pruebas para asegurarte de que todo funciona:

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

5. Instala el servidor en Claude Desktop: mcp install elevenlabs_mcp/server.py

6. Depura y prueba localmente con MCP Inspector: mcp dev elevenlabs_mcp/server.py

Solución de problemas

Los registros al usar con Claude Desktop se pueden encontrar en:

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

Tiempos de espera al usar ciertas herramientas

Ciertas operaciones de la API de ElevenLabs, como el diseño de voz y el aislamiento de audio, pueden tardar mucho tiempo en resolverse. Al usar el inspector MCP en modo de desarrollo, podrías obtener errores de tiempo de espera a pesar de que la herramienta complete su tarea prevista.

Esto no debería ocurrir al usar un cliente como Claude.

MCP ElevenLabs: spawn uvx ENOENT

Si encuentras el error "MCP ElevenLabs: spawn uvx ENOENT", confirma su ruta absoluta ejecutando este comando en tu terminal:

which uvx

Una vez que obtengas la ruta absoluta (por ejemplo, /usr/local/bin/uvx), actualiza tu configuración para usar esa ruta (por ejemplo, "command": "/usr/local/bin/uvx"). Esto asegura que se haga referencia al ejecutable correcto.