ElevenLabs

ElevenLabs MCP Server

Un servidor de Protocolo de Contexto de Modelo (MCP) que se integra con la API de texto a voz de ElevenLabs, con un componente de servidor y un Cliente MCP 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 de guion
• Base de datos SQLite para almacenamiento persistente del historial
• Cliente MCP de muestra SvelteKit para:
  • Conversión simple de texto a voz
  • Gestión de guiones de múltiples partes
  • Seguimiento y reproducción del historial de voces
  • Descargas de archivos de audio

Instalación

Instalación mediante Smithery

Para instalar ElevenLabs MCP Server para Claude Desktop automáticamente mediante Smithery:

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

Usando uvx (recomendado)

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

Añade la siguiente configuración a tu archivo de ajustes 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. Clona este repositorio
2. Instala las dependencias:

   uv venv
   

3. Copia .env.example a .env y completa tus 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 SvelteKit

1. Navega al directorio de la interfaz web:

   cd clients/web-ui
   

2. Instala las dependencias:

   pnpm install
   

3. Copia .env.example a .env y configura según sea necesario
4. Ejecuta la interfaz web:

   pnpm dev
   

5. Abre http://localhost:5174 en tu navegador

Herramientas disponibles

• generate_audio_simple: Genera audio a partir de texto plano usando la configuración de voz predeterminada
• generate_audio_script: Genera audio a partir de un guion estructurado con múltiples voces y actores
• delete_job: Elimina un trabajo por su ID
• get_audio_file: Obtiene 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, especifica un ID de trabajo para un trabajo concreto.

Recursos disponibles

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

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.