MiniMax MCP

MiniMax MCP

MiniMax MCP es el servidor oficial del Protocolo de Contexto de Modelo (MCP) de MiniMax, que permite a las aplicaciones de IA acceder de forma nativa a poderosas APIs de generación de voz, imagen y video. Integrado sin problemas con clientes MCP populares como Claude Desktop y Cursor, permite a los agentes basados en LLM realizar una amplia gama de tareas multimedia, incluyendo texto a audio, clonación de voz, generación de imágenes y videos, en un flujo de trabajo estandarizado y extensible.

Author: MiniMax-AI


Ver Protocolo

¿Qué es MiniMax MCP?

MiniMax MCP es una implementación de un servidor MCP que proporciona capacidades de texto a voz de alta calidad, clonación de voz, generación de imágenes y videos a clientes MCP. Al seguir la especificación abierta de MCP, permite que cualquier frontend o marco de agente LLM compatible aproveche las APIs multimodales de MiniMax a través de un protocolo unificado, admitiendo tanto integración local como en la nube.

Cómo Configurar MiniMax MCP

  1. Obtén una clave API y una URL de host de la plataforma MiniMax (elige la región adecuada: Global o Continental).
  2. Instala uv, el gestor de paquetes de Python requerido, usando curl -LsSf https://astral.sh/uv/install.sh | sh.
  3. Edita la configuración de tu cliente (por ejemplo, en claude_desktop_config.json de Claude Desktop o en la configuración de MCP de Cursor), añadiendo una nueva entrada de servidor MCP para MiniMax MCP.
    • Establece "command" a "uvx" o al path absoluto de uvx.
    • Añade tus variables de entorno MINIMAX_API_KEY y MINIMAX_API_HOST correspondientes.
    • Opcionalmente, establece la ruta base de salida y el modo de recurso para el manejo de archivos locales/URL.
  4. Para usuarios de Windows con Claude Desktop, habilita el Modo Desarrollador para activar servidores MCP personalizados.
  5. Guarda y reinicia tu cliente MCP para conectar y comenzar a utilizar MiniMax MCP.

Cómo Utilizar MiniMax MCP

Después de la configuración:

  • Abre tu herramienta de IA compatible con MCP (por ejemplo, Claude Desktop, Cursor).
  • Accede a las acciones o al panel de herramientas integrados en MCP.
  • Invoca herramientas como text_to_audio, text_to_image o generate_video proporcionando los prompts o archivos necesarios.
  • Para operaciones asíncronas (como videos), utiliza los endpoints y funciones de herramientas proporcionados para monitorear o recuperar resultados.
  • Ajusta el manejo de archivos locales/nube según utilices stdio o transporte SSE (red).
  • Revisa las respuestas u outputs de las APIs, que pueden guardarse en un directorio designado o accederse a través de URLs.

Características Clave

  • Integración directa plug-and-play con las principales herramientas de IA a través del protocolo MCP abierto.
  • Soporte multimodal que incluye texto a voz en tiempo real, clonación de voz de alta fidelidad y generación avanzada de texto a imagen/video.
  • Opciones de transporte flexibles: local (stdio) o en la nube (SSE).
  • Descubrimiento automático de recursos y invocación estándar de herramientas a través de endpoints MCP.
  • Acceso seguro a datos con soporte para separación de claves regionales y manejo de recursos locales/basados en URL.
  • Extensible a futuras modalidades y herramientas de generación de MiniMax.

Casos de Uso

  • Generar automáticamente audio de noticias de alta calidad a partir de scripts creados por LLM.
  • Clonar una voz específica y sintetizar audio en ese estilo para avatares de IA personalizados.
  • Generar e insertar instantáneamente imágenes o escenas de video dentro de flujos de trabajo de IA, como para la creación de presentaciones o asistencia en programación.
  • Encadenar MiniMax MCP con herramientas descendentes (por ejemplo, Claude, Cursor) para tareas complejas que mezclan generación de texto, código, visual y audio.
  • Crear datos de entrenamiento sintéticos, medios personalizados o automatizar flujos de contenido en escenarios creativos y empresariales.

Preguntas Frecuentes

1. ¿Cómo resuelvo errores de 'clave API inválida'? Asegúrate de que tu clave API coincida con el host de API correcto según tu región (Global: https://api.minimaxi.chat, Continental: https://api.minimax.chat). Obtén tu clave del centro de usuarios correcto de MiniMax y verifica que la escritura del host sea correcta.

2. Obtengo 'spawn uvx ENOENT' al iniciar el servidor. ¿Qué debo hacer? Asegúrate de que el ejecutable uvx esté disponible en la ruta de tu sistema o especifica su ruta absoluta en tu configuración. Puedes encontrarlo usando which uvx.

3. ¿Por qué no puedo usar las herramientas MiniMax MCP en Claude Desktop en Windows? Debes habilitar el Modo Desarrollador en Claude Desktop (desde el menú Ayuda) para permitir servidores MCP de terceros.

4. ¿Por qué no se completa una solicitud de generación de video? La generación de video puede ser asíncrona; define reglas de finalización en tu IDE o usa la herramienta query_video_generation para verificar el estado de tu tarea de generación de video.

5. ¿Existen costos asociados con el uso de estas herramientas? Sí, el uso de las APIs de MultiMax MCP (texto a voz, generación de video/imágenes, etc.) incurre en costos en la plataforma MiniMax. Consulta el panel de tu cuenta para obtener precios.