MiniMax-MCP MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

síntesis de voz con múltiples voces
clonación de voz desde muestras de audio
diseño de voz — generar una voz a partir de una descripción textual
texto a imagen y generate_video (asincrónico con query_video_generation)
generación de música con entrada de letras

Demo en vivo

Cómo se ve en la práctica

minimax.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "minimax": {
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "minimax": {
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "minimax": {
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "minimax": {
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "minimax",
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "minimax": {
      "command": {
        "path": "uvx",
        "args": [
          "MiniMax-MCP"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add minimax -- uvx MiniMax-MCP

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: MiniMax-MCP

Cómo convertir una entrada de blog en audio de narración

👤 Creadores, podcasters, equipos de accesibilidad ⏱ ~15 min beginner

Cuándo usarlo: Quieres una versión escuchable de contenido escrito.

Requisitos previos

Cuenta de MiniMax + clave API — Global: minimax.io; Continental: minimaxi.com. Establece MINIMAX_API_KEY + MINIMAX_API_HOST coincidiendo con la región
uvx instalado — brew install uv

Flujo

Listar voces

list_voices — mostrar todas las voces disponibles en inglés.✓ Copiado

→ Catálogo de voces con previsualizaciones
Renderizar audio

text_to_audio: [pega artículo] con voz 'female-calm-en'. Guarda en /audio/article.mp3.✓ Copiado

→ Archivo MP3 guardado, URL devuelta

Resultado: Versión de audio escuchable de tu contenido.

Errores comunes

Los artículos largos alcanzan los límites de caracteres por llamada — Divide en párrafos, renderiza y concatena
La pronunciación de nombres propios es incorrecta — Usa pistas fonéticas al estilo SSML o la herramienta voice_design para voces especializadas

Combinar con: filesystem

Cómo clonar tu propia voz para narración

👤 Creadores que quieren un narrador consistente ⏱ ~10 min intermediate

Cuándo usarlo: Quieres narración con IA en tu propia voz.

Requisitos previos

Muestra de voz de 10-60 segundos (audio limpio, tu voz) — Graba con tu teléfono; exporta como mp3/wav

Flujo

Clonar

voice_clone con muestra /recordings/me.wav, nombre 'my-voice'.✓ Copiado

→ ID de voz devuelto
Usarla

text_to_audio con voz='my-voice' en [pega texto].✓ Copiado

→ Salida en tu voz

Resultado: Narración personal sin micrófono cada vez.

Errores comunes

Usar la voz de otra persona sin consentimiento — No lo hagas — es un problema legal y ético; usa voice_design en su lugar

Cómo generar una imagen y convertirla en un vídeo corto

👤 Creadores de contenido, especialistas en marketing ⏱ ~15 min intermediate

Cuándo usarlo: Contenido para redes sociales, previsualizaciones de productos.

Flujo

Generar imagen

text_to_image: 'toma de producto minimalista de una taza de cerámica en estudio, luz natural'.✓ Copiado

→ URL de imagen
Animar

generate_video con mensaje 'taza rotando lentamente sobre una mesa de madera'. Consulta estado con query_video_generation.✓ Copiado

→ URL de vídeo cuando esté lista

Resultado: Clip de marketing breve.

Errores comunes

La generación de vídeo es asincrónica y puede tomar minutos — Siempre usa query_video_generation para consultar — no bloquees una conversación esperando

Combinar con: google-workspace

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

minimax + filesystem

Guardar recursos generados en una carpeta de contenido estructurada

Generar narración para cada capítulo en /manuscript/ y guardar MP3s en /audio/chapters/.✓ Copiado

minimax + google-workspace

Producir audio desde un Google Doc, luego adjuntarlo como enlace en el documento

Leer Doc 'Launch Post', generar narración, cargar a Drive, agregar el enlace como pie de página.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
text_to_audio	text: str, voice: str, format?: 'mp3'\|'wav', output_path?	Narrar texto	Según precios de TTS de MiniMax
list_voices	language?: str	Encontrar una voz	gratuito
voice_clone	sample_path: str, name: str	Voz personalizada	Según precios de MiniMax
voice_design	description: str	Generar una voz a partir de prosa	Según precios de MiniMax
text_to_image	prompt: str, aspect_ratio?	Generación de imagen	Según precios de imagen de MiniMax
generate_video	prompt: str, duration_s?	Iniciar generación de vídeo	Según precios de vídeo de MiniMax
query_video_generation	task_id	Consultar estado del trabajo de vídeo	gratuito
music_generation	lyrics: str, genre?: str	Crear una pista corta	Según precios de música de MiniMax

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Según el plan de MiniMax — verifica precios actuales en minimax.io o minimaxi.com
Tokens por llamada: Entrada de texto modesta; los resultados son archivos de audio/imagen/vídeo
Monetario: Pago por llamada; más barato empezar con equivalentes Flash/Hailuo-Mini
Consejo: Agrupa TTS cortos en menos llamadas más largas cuando sea posible; vídeo es el más caro — cachea resultados.

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: MINIMAX_API_KEY + MINIMAX_API_HOST coincidiendo con la región

Almacenamiento de credenciales: Variables de entorno

Salida de datos: Tu texto/audio se envía a los servidores de MiniMax en la región seleccionada

No conceder nunca: No mezcles claves globales y continentales — causa 'Clave API inválida'

Las voces clonadas son poderosas; solo clona voces para las que tengas consentimiento explícito.
El contenido generado puede estar sujeto a TOS de la plataforma — revisa antes del uso comercial.

Resolución de problemas

Errores comunes y soluciones

Clave API inválida

Clave y región de host deben coincidir. Establece MINIMAX_API_HOST=https://api.minimax.io para global o https://api.minimaxi.com para continental.

Verificar: env | grep MINIMAX

la generación de vídeo nunca se completa

Consulta con query_video_generation hasta 10 min; más de lo esperado generalmente significa carga del servidor. Reintenta con una nueva tarea si está atascado.

calidad de voice_clone deficiente

El audio de muestra debe ser 10-60s, limpio (sin música/ruido), un solo hablante.

Límite de tasa excedido

MiniMax aplica límites por minuto y por día. Retrocede; actualiza el plan para límites más altos.

Alternativas

MiniMax-MCP vs otros

Alternativa	Cuándo usarla	Contrapartida
ElevenLabs MCP	Quieres TTS orientado al mercado occidental con voces de inglés dedicadas	Sin vídeo/imagen/música en un solo paquete
OpenAI/Whisper for TTS	Ya tienes créditos de OpenAI	Menos opciones de voces que MiniMax

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills