ElevenLabs

Servidor oficial de ElevenLabs Model Context Protocol (MCP) que permite la interacción con potentes API 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 de API desde ElevenLabs. Hay un plan gratuito con 10 000 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 repositorio de uv 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, deberás 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 adecuado 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 a preguntarle 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ñadir 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 diferentes hablantes, luego conviértelo de nuevo usando voces únicas para cada persona"

Funcionalidades 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 archivo (por defecto: ~/Desktop). Este directorio también es el límite de seguridad para los 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 como ruta absoluta o relativa. Las rutas fuera de él — incluso si son absolutas y previamente aceptadas — son rechazadas. Establece esto en un directorio que contenga todo lo que necesites leer o escribir.
• ELEVENLABS_MCP_OUTPUT_MODE: Controla cómo se devuelven los archivos generados (por defecto: files)

Modos de salida

La variable de entorno ELEVENLABS_MCP_OUTPUT_MODE admite tres modos:

1. files (por defecto): Guarda los archivos en disco y devuelve las rutas de los archivos

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

2. resources: Devuelve los 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 los 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 el modo both, los recursos se pueden obtener más tarde usando el patrón de 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 uso compartido 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 funcionalidad solo para empresas. Consulta la documentación para más detalles.

Contribuir

Si deseas 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 de API de ElevenLabs:

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

4. Ejecuta las pruebas para verificar 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 ejecutar 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 en resolverse. Al usar el inspector MCP en modo de desarrollo, es posible que obtengas 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.