ElevenLabs MCP Server

Inicio rápido con Claude Desktop

1. Obtén tu clave API en ElevenLabs . Hay un plan gratuito con 10 000 créditos al mes.
2. Instale uv (administrador de paquetes de Python), instálelo con curl -LsSf https://astral.sh/uv/install.sh | sh o consulte el repositorio uv para obtener métodos de instalación adicionales.
3. Vaya a Claude > Configuración > Desarrollador > Editar configuración > claude_desktop_config.json para incluir lo siguiente:

Si usa Windows, deberá habilitar el "Modo de desarrollador" en Claude Desktop para usar el servidor MCP. Haga clic en "Ayuda" en el menú de la esquina superior izquierda y seleccione "Habilitar modo de desarrollador".

Otros clientes de MCP

Para otros clientes como Cursor y Windsurf, ejecute:

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

Listo. Tu cliente MCP ahora puede interactuar con ElevenLabs mediante estas herramientas:

Ejemplo de uso

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

Prueba a preguntarle a Claude:

• "Crear 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 dragón sabio y antiguo. Luego, elegiré mi voz favorita para agregarla a mi biblioteca de voces.
• "Convierte esta grabación de mi voz para que suene como la de un caballero medieval"
• Crea un paisaje sonoro de una tormenta eléctrica en una selva densa con animales que reaccionan al clima.
• "Convierte este discurso en texto, identifica a los diferentes oradores y luego conviértelo de nuevo usando voces únicas para cada persona".

Características opcionales

Puede agregar la variable de entorno ELEVENLABS_MCP_BASE_PATH a claude_desktop_config.json para especificar la ruta base que debe buscar el servidor MCP y los archivos de salida especificados con rutas relativas.

Contribuyendo

Si deseas contribuir o ejecutar desde la fuente:

1. Clonar el repositorio:

2. Cree un entorno virtual e instale dependencias usando uv :

3. Copie .env.example a .env y agregue su clave API de ElevenLabs:

4. Ejecute las pruebas para asegurarse de que todo funciona:

5. Instalar el servidor en Claude Desktop: mcp install elevenlabs_mcp/server.py
6. Depure y pruebe localmente con MCP Inspector: mcp dev elevenlabs_mcp/server.py

Solución de problemas

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

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

Tiempos de espera al utilizar ciertas herramientas

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

Esto no debería ocurrir cuando se utiliza un cliente como Claude.

MCP ElevenLabs: engendro uvx ENOENT

Si encuentra el error "MCP ElevenLabs: spawn uvx ENOENT", confirme su ruta absoluta ejecutando este comando en su terminal:

Una vez que obtenga la ruta absoluta (p. ej., /usr/local/bin/uvx ), actualice su configuración para usarla (p. ej., "command": "/usr/local/bin/uvx" ). Esto garantiza que se haga referencia al ejecutable correcto.