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

spimov-mcp

Servidor MCP para Spimov: dobla videos mediante Claude Desktop / Claude Code / cualquier cliente MCP.

Dos transportes:

• stdio: se ejecuta localmente, iniciado por tu cliente MCP, autenticado con la variable de entorno SPIMOV_API_KEY. Admite carga de archivos locales (create_dub).
• HTTP: servidor de larga duración (lo alojamos en mcp.spimov.com), autenticado por solicitud con Authorization: Bearer spk_live_... (o ?api_key=). Expone tanto Streamable HTTP (/mcp, especificación actual) como SSE heredado (/sse). Solo URL: sin carga de archivos locales.

Ambos transportes son envoltorios ligeros sobre la API REST pública en https://spimov.com/api/v1. La misma clave de API, la misma cuota diaria de solicitudes.

---

1. Obtén una clave de API

Inicia sesión en https://spimov.com → Configuración → Claves de API → Crear nueva clave. Copia el token spk_live_... que se muestra una sola vez.

2a. Uso mediante stdio (Claude Desktop)

Instalación:

pip install spimov-mcp

Agrega a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Reinicia Claude Desktop. El servidor MCP "spimov" debería aparecer; pídele a Claude que "doble /Users/me/Movies/clip.mp4 al turco usando Spimov".

2b. Uso mediante HTTP (Claude Code / Claude web / otros clientes)

Autohospedado: MCP_PORT=8001 spimov-mcp-http. Endpoints alojados:

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

Claude Code / clientes con archivo de configuración (autenticación por encabezado):

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

Claude web (claude.ai → Configuración → Conectores → Agregar conector personalizado): la interfaz solo acepta una URL, así que coloca la clave en la cadena de consulta:

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

La clave viaja en la URL (almacenada en la configuración de tu conector). Trátala como una contraseña y rótala desde Configuración → Claves de API si se filtra. Las herramientas de archivos locales (create_dub, download_video) no están disponibles aquí: usa dub_youtube para doblar y get_download_url para obtener un enlace de descarga en el navegador para el MP4 terminado.

3. Herramientas

Herramienta	Propósito
create_dub	Sube un archivo local y pon en cola un trabajo de doblaje (solo stdio).
dub_youtube	Dobla una URL de YouTube en el servidor; carga automática opcional a un canal.
get_job_status	Consulta un trabajo (en cola / procesando / revisión / completado / fallido).
list_jobs	Trabajos recientes de la cuenta.
list_segments	Segmentos de transcripción (texto, hablante, emoción, sincronización) de un trabajo.
update_segment	Edita el texto/emoción/hablante/omisión de un segmento y vuelve a sintetizar.
remix_video	Re-renderiza la mezcla de audio / subtítulos / sincronización de labios sin volver a doblar.
download_video	Guarda el MP4 terminado localmente (solo stdio).
get_download_url	Obtén un enlace de descarga en el navegador, compartible y con límite de tiempo, para el MP4 (úsalo con HTTP/web).
get_subtitles	Obtén SRT/VTT (cualquier idioma incrustado).
upload_to_youtube	Publica (o reintenta) un trabajo terminado en un canal conectado.
cancel_job	Cancelar/eliminar.
list_languages	Lista de idiomas de origen y destino (17 idiomas de destino).
get_quota	Uso actual de minutos y solicitudes frente a los límites del plan.

Las herramientas de doblaje (create_dub, dub_youtube) aceptan una voz de calidad opcional (predeterminada), chatterbox (voz con emoción) o elevenlabs (de pago).

4. Sobrescribir la base de la API (desarrollo)

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