ElevenLabs MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Enables text-to-speech audio generation using ElevenLabs' API, supporting multiple voices, script parts with different speakers, audio file management, and voice history tracking.

  • Provides persistent storage for voice generation history, allowing retrieval and management of past text-to-speech jobs.

  • Includes a sample SvelteKit MCP Client for text-to-speech conversion, multi-part script management, and audio file playback and downloads.

Servidor MCP de ElevenLabs

Un servidor de Protocolo de Contexto de Modelo (MCP) que se integra con la API de texto a voz de ElevenLabs, que incluye un componente de servidor y un cliente MCP basado en web de muestra (SvelteKit) para gestionar tareas de generación de voz.

Características

  • Generar audio a partir de texto usando la API de ElevenLabs
  • Soporte para múltiples voces y partes del guión
  • Base de datos SQLite para almacenamiento de historial persistente
  • Cliente MCP de SvelteKit de muestra para:
    • Conversión sencilla de texto a voz
    • Gestión de guiones de varias partes
    • Seguimiento y reproducción del historial de voz
    • Descargas de archivos de audio

Instalación

Instalación mediante herrería

Para instalar ElevenLabs MCP Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install elevenlabs-mcp-server --client claude

Uso de uvx (recomendado)

Al utilizar uvx , no se necesita ninguna instalación específica.

Agregue la siguiente configuración a su archivo de configuración de MCP (por ejemplo, cline_mcp_settings.json para Claude Desktop):

{ "mcpServers": { "elevenlabs": { "command": "uvx", "args": ["elevenlabs-mcp-server"], "env": { "ELEVENLABS_API_KEY": "your-api-key", "ELEVENLABS_VOICE_ID": "your-voice-id", "ELEVENLABS_MODEL_ID": "eleven_flash_v2", "ELEVENLABS_STABILITY": "0.5", "ELEVENLABS_SIMILARITY_BOOST": "0.75", "ELEVENLABS_STYLE": "0.1", "ELEVENLABS_OUTPUT_DIR": "output" } } } }

Instalación de desarrollo

  1. Clonar este repositorio
  2. Instalar dependencias:
    uv venv
  3. Copie .env.example a .env y complete sus credenciales de ElevenLabs
{ "mcpServers": { "elevenlabs": { "command": "uv", "args": [ "--directory", "path/to/elevenlabs-mcp-server", "run", "elevenlabs-mcp-server" ], "env": { "ELEVENLABS_API_KEY": "your-api-key", "ELEVENLABS_VOICE_ID": "your-voice-id", "ELEVENLABS_MODEL_ID": "eleven_flash_v2", "ELEVENLABS_STABILITY": "0.5", "ELEVENLABS_SIMILARITY_BOOST": "0.75", "ELEVENLABS_STYLE": "0.1", "ELEVENLABS_OUTPUT_DIR": "output" } } } }

Uso del cliente MCP de muestra de SvelteKit

  1. Navegue hasta el directorio de la interfaz web:
    cd clients/web-ui
  2. Instalar dependencias:
    pnpm install
  3. Copie .env.example a .env y configúrelo según sea necesario
  4. Ejecute la interfaz web:
    pnpm dev
  5. Abra http://localhost:5174 en su navegador

Herramientas disponibles

  • generate_audio_simple : Genera audio a partir de texto simple usando la configuración de voz predeterminada
  • generate_audio_script : Genera audio a partir de un guión estructurado con múltiples voces y actores
  • delete_job : Eliminar un trabajo por su ID
  • get_audio_file : Obtener el archivo de audio por su ID
  • list_voices : Lista todas las voces disponibles
  • get_voiceover_history : Obtiene el historial de trabajos de locución. Opcionalmente, especifique un ID de trabajo para un trabajo específico.

Recursos disponibles

  • voiceover://history/{job_id} : Obtener el archivo de audio por su ID
  • voiceover://voices : Lista todas las voces disponibles

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

ID: leukzvus7o