MiniMax MCP

oficial

Interactúa con las potentes APIs de MiniMax para generación de texto a voz, imágenes y videos.

¿Qué puedes hacer con MiniMax MCP?

  • Texto a voz — Pide al asistente que convierta texto escrito en audio usando una voz específica.
  • Clonación de voz — Clona una voz a partir de archivos de audio que proporciones y luego reutilízala para generar voz.
  • Diseño de voz — Genera una voz personalizada a partir de una descripción, con audio de vista previa.
  • Generación y edición de imágenes — Crea imágenes a partir de indicaciones en áreas de 1K/2K/4K o edita una imagen usando una indicación y hasta 16 imágenes de referencia.
  • Generación de video — Genera un video a partir de una indicación, con opciones de duración y resolución, y consulta el resultado de la tarea después.

Documentación

export

Servidor oficial MiniMax Model Context Protocol (MCP) que permite interactuar con potentes API de conversión de texto a voz y de generación de vídeo e imágenes. Este servidor permite a clientes MCP como Claude Desktop, Cursor, Windsurf, OpenAI Agents y otros generar voz, clonar voces, generar vídeos e imágenes, y mucho más.

💡 Recomendado: MiniMax CLI (mmx-cli) — nuestra herramienta oficial de línea de comandos, con los modelos más recientes y funciones adicionales, como texto, visión y búsqueda. Funciona como una habilidad de agente de IA para Claude Code, Cursor, OpenClaw, etc.

Documentación

Inicio rápido con un cliente MCP

  1. Obtén tu clave de API en MiniMax.
  2. Instala uv (administrador de paquetes de Python); instala con curl -LsSf https://astral.sh/uv/install.sh | sh o consulta el repositorio de uv para ver otros métodos de instalación.
  3. Importante: El host y la clave de API varían según la región y deben coincidir; de lo contrario, aparecerá un error Invalid API key.
RegiónGlobalChina continental
MINIMAX_API_KEYobténla en MiniMax Globalobténla en MiniMax
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

Claude Desktop

Ve a Claude > Settings > Developer > Edit Config > claude_desktop_config.json para incluir lo siguiente:

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "insert-your-api-key-here",
        "MINIMAX_MCP_BASE_PATH": "local-output-dir-path, such as /User/xxx/Desktop",
        "MINIMAX_API_HOST": "api host, https://api.minimax.io | https://api.minimaxi.com",
        "MINIMAX_API_RESOURCE_MODE": "optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format"
      }
    }
  }
}

⚠️ Advertencia: La clave de API debe coincidir con el host. Si aparece el error "API Error: invalid api key", comprueba el host de la API:

  • Host global: https://api.minimax.io
  • Host de China continental: https://api.minimaxi.com

Si usas Windows, debes habilitar el "Modo de desarrollador" en Claude Desktop para usar el servidor MCP. Haz clic en "Ayuda" en el menú de hamburguesa de la esquina superior izquierda y selecciona "Habilitar modo de desarrollador".

Cursor

Ve a Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server para añadir la configuración anterior.

Eso es todo. Tu cliente MCP ya puede interactuar con MiniMax mediante estas herramientas:

Transporte

Admitimos dos tipos de transporte: stdio y sse.

stdioSSE
Ejecución localSe puede implementar localmente o en la nube
Comunicación mediante stdoutComunicación mediante network
Entrada: admite el procesamiento de recursos local files o URL válidosEntrada: cuando se implementa en la nube, se recomienda usar URL como entrada

Herramientas disponibles

herramientadescripción
text_to_audioConvierte texto en audio con una voz determinada
list_voicesMuestra todas las voces disponibles
voice_cloneClona una voz usando los archivos de audio proporcionados
generate_videoGenera un vídeo a partir de una indicación
text_to_imageGenera una imagen a partir de una indicación. De forma predeterminada, usa MiniMax-H3-Image (admite area 1K/2K/4K y size); image-01 sigue disponible mediante model
image_editEdita una imagen con MiniMax-H3-Image usando una indicación y entre 1 y 16 imágenes de referencia
query_video_generationConsulta el resultado de una tarea de generación de vídeo
voice_designGenera una voz a partir de una indicación usando texto de vista previa

Notas de la versión

10 de noviembre de 2026

🆕 Novedades

  • Edición de imágenes: nueva herramienta image_edit — edita imágenes con MiniMax-H3-Image usando una indicación y entre 1 y 16 imágenes de referencia (URL, URI de datos, mm_file:// o ruta local)
  • Generación de imágenes H3: text_to_image ahora usa MiniMax-H3-Image de forma predeterminada y admite area (1K/2K/4K) y size; image-01 sigue disponible mediante el parámetro model

📈 Herramientas mejoradas

  • text_to_image - Usa MiniMax-H3-Image de forma predeterminada (/v1/images/generations); pasa model="image-01" para usar el modelo anterior

2 de julio de 2025

🆕 Novedades

  • Diseño de voz: nueva herramienta voice_design - crea voces personalizadas a partir de indicaciones descriptivas con audio de vista previa
  • Mejora de vídeo: se añadió el modelo MiniMax-Hailuo-02, con calidad ultra nítida y controles de duración y resolución

📈 Herramientas mejoradas

  • voice_design - Genera voces personalizadas a partir de descripciones de texto
  • generate_video - Ahora admite MiniMax-Hailuo-02 con opciones de duración de 6 s/10 s y resolución de 768P/1080P

Preguntas frecuentes

1. Clave de API no válida

Asegúrate de que la clave y el host de la API correspondan a la misma región

RegiónGlobalChina continental
MINIMAX_API_KEYobténla en MiniMax Globalobténla en MiniMax
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

2. spawn uvx ENOENT

Confirma la ruta absoluta ejecutando este comando en tu terminal:

which uvx

Cuando obtengas la ruta absoluta (p. ej., /usr/local/bin/uvx), actualiza la configuración para usar esa ruta (p. ej., "command": "/usr/local/bin/uvx").

3. Cómo usar generate_video en modo asíncrono

Define las reglas de finalización antes de empezar: También puedes configurar estas reglas en los ajustes de tu IDE (p. ej., Cursor):

Ejemplos de uso

⚠️ Advertencia: El uso de estas herramientas puede generar costes.

1. Locutar un segmento del noticiero nocturno

2. Clonar una voz

3. Generar un vídeo

4. Generar imágenes