MiniMax MCP

Servidor oficial del Protocolo de Contexto de Modelo (MCP) de MiniMax que permite la interacción con potentes APIs de texto a voz y generación de video/imágenes. Este servidor permite que clientes MCP como Claude Desktop, Cursor, Windsurf, OpenAI Agents y otros generen voz, clonen voces, generen video, generen imágenes y más.

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

Documentación

• 中文文档
• MiniMax-MCP-JS - Implementación oficial en JavaScript de MiniMax MCP

Inicio rápido con el 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 métodos de instalación adicionales.
3. Importante: El host y la clave de la API varían según la región y deben coincidir; de lo contrario, encontrarás un error de Invalid API key.

Región	Global	China continental
MINIMAX_API_KEY	obténla en MiniMax Global	obténla en MiniMax
MINIMAX_API_HOST	https://api.minimax.io	https://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", verifica tu host de API:

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

Si usas Windows, deberás habilitar el "Modo Desarrollador" en Claude Desktop para usar el servidor MCP. Haz clic en "Ayuda" en el menú de hamburguesa en la parte superior izquierda y selecciona "Habilitar Modo Desarrollador".

Cursor

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

Eso es todo. Tu cliente MCP ahora puede interactuar con MiniMax a través de estas herramientas:

Transporte

Soportamos dos tipos de transporte: stdio y sse.

stdio	SSE
Se ejecuta localmente	Se puede implementar localmente o en la nube
Comunicación a través de stdout	Comunicación a través de network
Entrada: Admite el procesamiento de recursos local files o URL válidos	Entrada: Cuando se implementa en la nube, se recomienda usar URL para la entrada

Herramientas disponibles

herramienta	descripción
text_to_audio	Convierte texto a audio con una voz determinada
list_voices	Lista todas las voces disponibles
voice_clone	Clona una voz usando archivos de audio proporcionados
generate_video	Genera un video a partir de un prompt
text_to_image	Genera una imagen a partir de un prompt
query_video_generation	Consulta el resultado de la tarea de generación de video
music_generation	Genera una pista musical a partir de un prompt y letras
voice_design	Genera una voz a partir de un prompt usando texto de vista previa

Notas de la versión

2 de julio de 2025

🆕 Novedades

• Diseño de voz: Nueva herramienta voice_design: crea voces personalizadas a partir de prompts descriptivos con audio de vista previa
• Mejora de video: Se agregó el modelo MiniMax-Hailuo-02 con calidad ultra nítida y controles de duración/resolución
• Generación de música: Herramienta mejorada music_generation impulsada por el modelo music-1.5

📈 Herramientas mejoradas

• voice_design - Genera voces personalizadas a partir de descripciones de texto
• generate_video - Ahora admite MiniMax-Hailuo-02 con duración de 6s/10s y opciones de resolución 768P/1080P
• music_generation - Creación de música de alta calidad con el modelo music-1.5

Preguntas frecuentes

1. invalid api key

Asegúrate de que tu clave de API y tu host de API estén alineados regionalmente

Región	Global	China continental
MINIMAX_API_KEY	obténla en MiniMax Global	obténla en MiniMax
MINIMAX_API_HOST	https://api.minimax.io	https://api.minimaxi.com

2. spawn uvx ENOENT

Confirma su ruta absoluta ejecutando este comando en tu terminal:

which uvx

Una vez que obtengas la ruta absoluta (por ejemplo, /usr/local/bin/uvx), actualiza tu configuración para usar esa ruta (por ejemplo, "command": "/usr/local/bin/uvx").

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

Define reglas de finalización antes de comenzar: Alternativamente, estas reglas se pueden configurar en la configuración de tu IDE (por ejemplo, Cursor):

Ejemplo de uso

⚠️ Advertencia: Usar estas herramientas puede generar costos.

1. transmitir un segmento de las noticias de la noche

2. clonar una voz

3. generar un video

4. generar imágenes