ElevenLabs

ElevenLabs MCP Server

Um servidor Model Context Protocol (MCP) que integra a API de texto-para-fala da ElevenLabs, apresentando tanto um componente de servidor quanto um cliente MCP de exemplo baseado na web (SvelteKit) para gerenciar tarefas de geração de voz.

Recursos

• Gere áudio a partir de texto usando a API da ElevenLabs
• Suporte para múltiplas vozes e partes de roteiro
• Banco de dados SQLite para armazenamento persistente de histórico
• Cliente MCP de exemplo em SvelteKit para:
  • Conversão simples de texto para fala
  • Gerenciamento de roteiros com múltiplas partes
  • Rastreamento e reprodução do histórico de vozes
  • Download de arquivos de áudio

Instalação

Instalando via Smithery

Para instalar o ElevenLabs MCP Server para Claude Desktop automaticamente via Smithery:

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

Usando uvx (recomendado)

Ao usar uvx, nenhuma instalação específica é necessária.

Adicione a seguinte configuração ao seu arquivo de configurações MCP (por exemplo, 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"
      }
    }
  }
}

Instalação para Desenvolvimento

1. Clone este repositório
2. Instale as dependências:

   uv venv
   

3. Copie .env.example para .env e preencha com suas credenciais da 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"
      }
    }
  }
}

Usando o Cliente MCP de Exemplo SvelteKit

1. Navegue até o diretório da interface web:

   cd clients/web-ui
   

2. Instale as dependências:

   pnpm install
   

3. Copie .env.example para .env e configure conforme necessário
4. Execute a interface web:

   pnpm dev
   

5. Abra http://localhost:5174 no seu navegador

Ferramentas Disponíveis

• generate_audio_simple: Gere áudio a partir de texto simples usando as configurações de voz padrão
• generate_audio_script: Gere áudio a partir de um roteiro estruturado com múltiplas vozes e atores
• delete_job: Exclua um trabalho pelo seu ID
• get_audio_file: Obtenha o arquivo de áudio pelo seu ID
• list_voices: Liste todas as vozes disponíveis
• get_voiceover_history: Obtenha o histórico de trabalhos de narração. Opcionalmente, especifique um ID de trabalho para um trabalho específico.

Recursos Disponíveis

• voiceover://history/{job_id}: Obtenha o arquivo de áudio pelo seu ID
• voiceover://voices: Liste todas as vozes disponíveis

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.