elevenlabs-mcp

Inicio rápido con Claude Desktop

1. Obtén tu clave de API de ElevenLabs. Existe un nivel gratuito con 10k créditos al mes.

2. Instala uv (gestor de paquetes de Python), instálalo con curl -LsSf https://astral.sh/uv/install.sh | sh o consulta el repositorio de uv para otros métodos de instalación.

3. Ve a Claude > Settings > Developer > Edit Config > 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 de desarrollador" en Claude Desktop para usar el servidor MCP. Haz clic en "Help" en el menú de hamburguesa en la parte superior izquierda y selecciona "Enable Developer Mode".

Related MCP server: ElevenLabs MCP Server

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 sabio y antiguo, 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 selva densa con animales reaccionando al clima"

• "Convierte este discurso a texto, identifica a los diferentes hablantes y luego conviértelo de nuevo usando voces únicas para cada persona"

Funciones 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 archivo con rutas relativas (predeterminado: ~/Desktop)

• 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 el disco y devuelve las rutas de los archivos

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

2. resources: Devuelve archivos como recursos MCP; los datos binarios están codificados 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 el disco Y los devuelve como recursos MCP

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

Beneficios del modo de recursos:

• Los archivos se devuelven directamente en la respuesta MCP como datos codificados en base64

• No 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 el 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 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 función exclusiva para empresas. Consulta la documentación para obtener más detalles.

Contribución

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 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 el Inspector MCP: 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 tiempo 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.