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

Related MCP server: ElevenLabs Text-to-Speech MCP

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.