ElevenLabs

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 a clientes MCP como Claude Desktop, Cursor, Windsurf, OpenAI Agents y otros generar voz, clonar voces, transcribir audio y más.

Inicio rápido con Claude Desktop

1. Obtén tu clave API desde 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 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ú hamburguesa de la esquina 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.

Intenta 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 anciano 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 eléctrica en una jungla densa con animales reaccionando al clima"
• "Convierte este discurso en texto, identifica diferentes hablantes y 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 operaciones de archivos con rutas relativas (por defecto: ~/Desktop)
• 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 archivos en disco y devuelve las 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 en contenedores 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 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 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. Por defecto 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 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 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 (p. ej., /usr/local/bin/uvx), actualiza tu configuración para usar esa ruta (p. ej., "command": "/usr/local/bin/uvx"). Esto asegura que se haga referencia al ejecutable correcto.