Spimov AI Video Dubbing MCP Server - Youtube Dubbing - Voice Clone

spimov-mcp

Servidor MCP para Spimov — duble vídeos via Claude Desktop / Claude Code / qualquer cliente MCP.

Dois transportes:

• stdio — roda localmente, iniciado pelo seu cliente MCP, autenticado com a variável de ambiente SPIMOV_API_KEY. Suporta upload de arquivo local (create_dub).
• HTTP — servidor de longa duração (hospedamos em mcp.spimov.com), autenticado por requisição com Authorization: Bearer spk_live_... (ou ?api_key=). Expõe tanto Streamable HTTP (/mcp, especificação atual) quanto SSE legado (/sse). Somente URL — sem upload de arquivo local.

Ambos os transportes são wrappers finos sobre a API REST pública em https://spimov.com/api/v1. A mesma chave de API, a mesma cota diária de requisições.

---

1. Obtenha uma chave de API

Entre em https://spimov.com → Configurações → Chaves de API → Criar nova chave. Copie o token spk_live_... exibido uma vez.

2a. Uso via stdio (Claude Desktop)

Instale:

pip install spimov-mcp

Adicione em ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "spimov": {
      "command": "spimov-mcp",
      "env": {
        "SPIMOV_API_KEY": "spk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Reinicie o Claude Desktop. O servidor MCP "spimov" deve aparecer; peça ao Claude para "dublar /Users/me/Movies/clip.mp4 para turco usando Spimov".

2b. Uso via HTTP (Claude Code / Claude web / outros clientes)

Auto-hospedado: MCP_PORT=8001 spimov-mcp-http. Endpoints hospedados:

• Streamable HTTP (recomendado): https://mcp.spimov.com/mcp
• SSE legado: https://mcp.spimov.com/sse

Clientes Claude Code / arquivo de configuração (autenticação por cabeçalho):

{
  "mcpServers": {
    "spimov": {
      "url": "https://mcp.spimov.com/mcp",
      "headers": {
        "Authorization": "Bearer spk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude web (claude.ai → Configurações → Conectores → Adicionar conector personalizado): a interface só aceita uma URL, então coloque a chave na string de consulta:

https://mcp.spimov.com/mcp?api_key=spk_live_xxxxxxxxxxxxxxxxxxxxxxxx

A chave viaja na URL (armazenada na configuração do seu conector). Trate-a como uma senha e rotacione-a em Configurações → Chaves de API se vazar. As ferramentas de arquivo local (create_dub, download_video) estão indisponíveis aqui — use dub_youtube para dublar e get_download_url para obter um link de download clicável no navegador para o MP4 finalizado.

3. Ferramentas

Ferramenta	Finalidade
create_dub	Enviar um arquivo local e colocar um trabalho de dublagem na fila (somente stdio).
dub_youtube	Dublar uma URL do YouTube no servidor; upload automático opcional para um canal.
get_job_status	Consultar um trabalho (na fila / processando / revisão / concluído / falhou).
list_jobs	Trabalhos recentes da conta.
list_segments	Segmentos de transcrição (texto, falante, emoção, tempo) de um trabalho.
update_segment	Editar o texto/emoção/falante/pular de um segmento e ressintetizar.
remix_video	Re-renderizar mix de áudio / legendas / sincronia labial sem re-dublar.
download_video	Salvar o MP4 finalizado localmente (somente stdio).
get_download_url	Obter um link de download compartilhável e com tempo limitado no navegador para o MP4 (use isso via HTTP/web).
get_subtitles	Obter SRT/VTT (qualquer idioma incorporado).
upload_to_youtube	Publicar (ou tentar novamente) um trabalho finalizado em um canal conectado.
cancel_job	Cancelar/excluir.
list_languages	Lista de idiomas de origem e destino (17 idiomas de destino).
get_quota	Uso atual de minutos e requisições vs. limites do plano.

As ferramentas de dublagem (create_dub, dub_youtube) aceitam um opcional (voz de qualidade, padrão), chatterbox (voz emocional) ou elevenlabs (pago).

4. Substituir a base da API (desenvolvimento)

SPIMOV_API_BASE=http://localhost:8000/api/v1 spimov-mcp