MiniMax MCP JS

Implementación de JavaScript/TypeScript de MiniMax MCP, que proporciona generación de imágenes, generación de video, conversión de texto a voz y más.

Documentación

Lengua china
Versión en Python : implementación oficial en Python de MiniMax MCP

Características

Texto a voz (TTS)
Generación de imágenes
Generación de vídeo
Clonación de voz
Configuración dinámica (admite tanto variables de entorno como parámetros de solicitud)
Compatible con el alojamiento de la plataforma MCP (ModelScope y otras plataformas MCP)

Instalación

# Install with pnpm (recommended)
pnpm add minimax-mcp-js

Inicio rápido

MiniMax MCP JS implementa la especificación del Protocolo de contexto de modelo (MCP) y se puede utilizar como servidor para interactuar con clientes compatibles con MCP (como Claude AI).

Inicio rápido con el cliente MCP

Obtenga su clave API de MiniMax International Platform .
Instalar minimax-mcp-js usando pnpm: pnpm add minimax-mcp-js
Importante: API HOST&KEY son diferentes en distintas regiones , deben coincidir, de lo contrario recibirá un error Invalid API key .

Región	Global	Continente
CLAVE DE API MINIMAX	Ve a buscarlo en MiniMax Global	Ve a buscarlo a MiniMax
HOST DE API MINIMAX	https://api.minimaxi.chat (nótese la "i" adicional)	https://api.minimax.chat

Uso con clientes MCP (recomendado)

Instalar la herramienta CLI globalmente:

# Install globally
pnpm install -g minimax-mcp-js

Configure su cliente MCP:

Escritorio de Claude

Vaya a Claude > Settings > Developer > Edit Config > claude_desktop_config.json para incluir:

{
  "mcpServers": {
    "minimax-mcp-js": {
      "command": "npx",
      "args": [
        "minimax-mcp-js"
      ],
      "env": {
        "MINIMAX_API_HOST": "https://api.minimaxi.chat",
        "MINIMAX_API_KEY": "<your-api-key-here>",
        "MINIMAX_MCP_BASE_PATH": "<local-output-dir-path, such as /User/xxx/Desktop>",
        "MINIMAX_RESOURCE_MODE": "<optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format>"
      }
    }
  }
}

Cursor

Vaya a Cursor → Preferences → Cursor Settings → MCP → Add new global MCP Server para agregar la configuración anterior.

⚠️ Nota : Si encuentra el error "No se encontraron herramientas" al usar MiniMax MCP JS con Cursor, actualice su Cursor a la última versión. Para más información, consulte este hilo de discusión .

Listo. Tu cliente MCP ya puede interactuar con MiniMax mediante estas herramientas.

Para el desarrollo local : al desarrollar localmente, puede usar npm link para probar sus cambios:

# In your project directory
npm link

Luego, configure Claude Desktop o Cursor para usar npx como se muestra arriba. Esto usará automáticamente la versión vinculada.

⚠️ Nota : La clave API debe coincidir con la dirección del host. Se utilizan diferentes hosts para las versiones global y de China continental:

Host global: https://api.minimaxi.chat (tenga en cuenta la "i" adicional)
Host de China continental: https://api.minimaxi.chat

Modos de transporte

MiniMax MCP JS admite tres modos de transporte:

Característica	stdio (predeterminado)	DESCANSAR	SSE
Ambiente	Solo local	Implementación local o en la nube	Implementación local o en la nube
Comunicación	A través de `standard I/O`	A través de `HTTP requests`	A través de `server-sent events`
Casos de uso	Integración de cliente MCP local	Servicios API, llamadas entre idiomas	Aplicaciones que requieren empuje del servidor
Restricciones de entrada	Admite `local files` o recursos `URL`	Cuando se implementa en la nube, se recomienda ingresar `URL`	Cuando se implementa en la nube, se recomienda ingresar `URL`

Configuración

MiniMax-MCP-JS ofrece múltiples métodos de configuración flexibles para adaptarse a diferentes casos de uso. La prioridad de configuración, de mayor a menor, es la siguiente:

1. Configuración de parámetros de solicitud (máxima prioridad)

En entornos de alojamiento de plataformas (como ModelScope u otras plataformas MCP), puede proporcionar una configuración independiente para cada solicitud a través del objeto meta.auth en los parámetros de la solicitud:

{
  "params": {
    "meta": {
      "auth": {
        "api_key": "your_api_key_here",
        "api_host": "https://api.minimaxi.chat",
        "base_path": "/path/to/output",
        "resource_mode": "url"
      }
    }
  }
}

Este método permite el uso por parte de múltiples inquilinos, donde cada solicitud puede utilizar diferentes claves de API y configuraciones.

2. Configuración de la API

Cuando se utiliza como módulo en otros proyectos, puede pasar la configuración a través de la función startMiniMaxMCP :

import { startMiniMaxMCP } from 'minimax-mcp-js';

await startMiniMaxMCP({
  apiKey: 'your_api_key_here',
  apiHost: 'https://api.minimaxi.chat',
  basePath: '/path/to/output',
  resourceMode: 'url'
});

3. Argumentos de la línea de comandos

Cuando se utiliza como herramienta CLI, puede proporcionar configuración a través de argumentos de la línea de comandos:

minimax-mcp-js --api-key your_api_key_here --api-host https://api.minimaxi.chat --base-path /path/to/output --resource-mode url

4. Variables de entorno (prioridad más baja)

El método de configuración más básico es mediante variables de entorno:

# MiniMax API Key (required)
MINIMAX_API_KEY=your_api_key_here

# Base path for output files (optional, defaults to user's desktop)
MINIMAX_MCP_BASE_PATH=~/Desktop

# MiniMax API Host (optional, defaults to https://api.minimaxi.chat)
MINIMAX_API_HOST=https://api.minimaxi.chat

# Resource mode (optional, defaults to 'url')
# Options: 'url' (return URLs), 'local' (save files locally)
MINIMAX_RESOURCE_MODE=url

Prioridad de configuración

Cuando se utilizan varios métodos de configuración, se aplica el siguiente orden de prioridad (del mayor al menor):

Configuración a nivel de solicitud (a través de meta.auth en cada solicitud de API)
Argumentos de la línea de comandos
Variables de entorno
Archivo de configuración
Valores predeterminados

Esta priorización garantiza flexibilidad en diferentes escenarios de implementación y al mismo tiempo mantiene capacidades de configuración por solicitud para entornos de múltiples inquilinos.

Parámetros de configuración

Parámetro	Descripción	Valor predeterminado
clave API	Clave API de MiniMax	Ninguno (obligatorio)
apiHost	Host de API de MiniMax	https://api.minimaxi.chat
ruta base	Ruta base para los archivos de salida	Escritorio del usuario
modoRecursos	Modo de manejo de recursos, 'url' o 'local'	URL

⚠️ Nota : La clave API debe coincidir con la dirección del host. Se utilizan diferentes hosts para las versiones global y de China continental:

Host global: https://api.minimaxi.chat (tenga en cuenta la "i" adicional)
Host de China continental: https://api.minimaxi.chat

Ejemplo de uso

⚠️ Advertencia: El uso de 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

Herramientas disponibles

Texto a audio

Convertir texto en archivo de audio de voz.

Nombre de la herramienta: text_to_audio

Parámetros:

text : Texto a convertir (obligatorio)
model : versión del modelo, las opciones son 'speech-02-hd', 'speech-02-turbo', 'speech-01-hd', 'speech-01-turbo', 'speech-01-240228', 'speech-01-turbo-240228', el valor predeterminado es 'speech-02-hd'
voiceId : ID de voz, el valor predeterminado es 'male-qn-qingse'
speed : velocidad del habla, rango 0,5-2,0, el valor predeterminado es 1,0
vol : Volumen, rango 0,1-10,0, el valor predeterminado es 1,0
pitch : Tono, rango -12 a 12, predeterminado 0
emotion : Emoción. Las opciones son "feliz", "triste", "enojado", "temeroso", "disgustado", "sorprendido", "neutral". El valor predeterminado es "feliz". Nota: Este parámetro solo funciona con los modelos "speech-02-hd", "speech-02-turbo", "speech-01-turbo" y "speech-01-hd".
format : Formato de audio, las opciones son 'mp3', 'pcm', 'flac', 'wav', el valor predeterminado es 'mp3'
sampleRate : frecuencia de muestreo (Hz), las opciones son 8000, 16000, 22050, 24000, 32000, 44100, el valor predeterminado es 32000
bitrate : Bitrate (bps), las opciones son 64000, 96000, 128000, 160000, 192000, 224000, 256000, 320000, el valor predeterminado es 128000
channel : canales de audio, las opciones son 1 o 2, el valor predeterminado es 1
languageBoost : Mejora del idioma, el valor predeterminado es 'automático'
latexRead : Habilita la lectura de fórmulas LaTeX
pronunciationDict : Diccionario de pronunciación
stream : Habilitar salida de streaming
subtitleEnable : Habilitar la generación de subtítulos
outputDirectory : Directorio para guardar el archivo de salida (opcional)
outputFile : Ruta para guardar el archivo de salida (opcional, se genera automáticamente si no se proporciona)

Texto a imagen

Generar imágenes basadas en indicaciones de texto.

Nombre de la herramienta: text_to_image

Parámetros:

prompt : Descripción de la imagen (obligatorio)
model : Versión del modelo, el valor predeterminado es 'image-01'
aspectRatio : Relación de aspecto, el valor predeterminado es '1:1', las opciones son '1:1', '16:9', '4:3', '3:2', '2:3', '3:4', '9:16', '21:9'
n : Número de imágenes a generar, rango 1-9, el valor predeterminado es 1
promptOptimizer : si se debe optimizar el mensaje, el valor predeterminado es verdadero
subjectReference : Ruta al archivo de imagen local o URL pública para referencia del personaje (opcional)
outputDirectory : Directorio para guardar el archivo de salida (opcional)
outputFile : Ruta para guardar el archivo de salida (opcional, se genera automáticamente si no se proporciona)

Generar vídeo

Generar vídeos basados en indicaciones de texto.

Nombre de la herramienta: generate_video

Parámetros:

prompt : Descripción del vídeo (obligatorio)
model : Versión del modelo, las opciones son 'T2V-01', 'T2V-01-Director', 'I2V-01', 'I2V-01-Director', 'I2V-01-live', 'S2V-01', el valor predeterminado es 'T2V-01'
firstFrameImage : Ruta a la imagen del primer fotograma (opcional)
outputDirectory : Directorio para guardar el archivo de salida (opcional)
outputFile : Ruta para guardar el archivo de salida (opcional, se genera automáticamente si no se proporciona)

Clon de voz

Clonar una voz de un archivo de audio.

Nombre de la herramienta: voice_clone

Parámetros:

audioFile : Ruta al archivo de audio (obligatorio)
voiceId : ID de voz (obligatorio)
text : Texto para audio de demostración (opcional)
outputDirectory : Directorio para guardar el archivo de salida (opcional)

Desarrollo

Configuración

# Clone the repository
git clone https://github.com/MiniMax-AI/MiniMax-MCP-JS.git
cd minimax-mcp-js

# Install dependencies
pnpm install

Construir

# Build the project
pnpm run build

Correr

# Run the MCP server
pnpm start

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Integrations

MiniMax MCP JS

Documentación

Características

Instalación

Inicio rápido

Inicio rápido con el cliente MCP

Uso con clientes MCP (recomendado)

Escritorio de Claude

Cursor

Modos de transporte

Configuración

1. Configuración de parámetros de solicitud (máxima prioridad)

2. Configuración de la API

3. Argumentos de la línea de comandos

4. Variables de entorno (prioridad más baja)

Prioridad de configuración

Parámetros de configuración

Ejemplo de uso

1. transmitir un segmento de las noticias de la noche

2. clonar una voz

3. generar un video

4. generar imágenes

Herramientas disponibles

Texto a audio

Texto a imagen

Generar vídeo

Clon de voz

Desarrollo

Configuración

Construir

Correr

Licencia