mmx-mcp-server

Un servidor MCP multimodal unificado de MiniMax, basado en el CLI mmx, que admite texto, búsqueda, comprensión de imágenes, generación de imágenes, síntesis de voz, generación de video, generación de música y consulta de cuotas.

README en inglés

Inicio rápido (configuración en una frase)

Si utilizas Claude Code, OpenCode u otras herramientas CLI de IA compatibles con MCP, simplemente proporciona el siguiente texto a la IA:

Ayúdame a instalar y configurar mmx-mcp-server:

1. Instala globalmente mmx-cli (npm install -g mmx-cli)

2. Clona https://github.com/zth0828/mmx-mcp-server en cualquier directorio, ejecuta npm install && npm run build

3. Añade el servidor mmx en mi archivo de configuración de MCP (como ~/.claude/settings.json), apuntando al producto de compilación dist/index.js

4. Pídeme la clave API de MiniMax e inyéctala a través de env.MINIMAX_API_KEY

5. Avísame cuando la configuración esté completa

Instalación manual

1. Instalar el CLI mmx (si aún no está instalado)

npm install -g mmx-cli

Verificar la instalación:

mmx --version

2. Instalar y compilar el servidor MCP

git clone https://github.com/zth0828/mmx-mcp-server.git
cd mmx-mcp-server
npm install
npm run build

3. Configurar la clave API

Añade lo siguiente en la configuración del cliente MCP (como ~/.claude/settings.json):

Método 1: Pasar la clave API mediante variables de entorno (recomendado)

{
  "mcpServers": {
    "mmx": {
      "command": "node",
      "args": ["/path/to/mmx-mcp-server/dist/index.js"],
      "env": {
        "MINIMAX_API_KEY": "sk-xxxxx"
      }
    }
  }
}

Método 2: Pasar la clave API mediante argumentos de línea de comandos

Adecuado para clientes MCP donde no es conveniente escribir env:

{
  "mcpServers": {
    "mmx": {
      "command": "node",
      "args": [
        "/path/to/mmx-mcp-server/dist/index.js",
        "--api-key",
        "sk-xxxxx"
      ]
    }
  }
}

Método 3: Depender del inicio de sesión local del CLI mmx

Si no se han configurado los dos métodos anteriores, el servidor volverá automáticamente al estado de autenticación del propio CLI mmx (es necesario ejecutar mmx auth login --api-key sk-xxxxx previamente). Este método solo es adecuado para uso local.

Directorio de salida personalizado (opcional)

De forma predeterminada, las imágenes, videos, música y voz generados se guardarán automáticamente en subcarpetas dentro del directorio de trabajo actual:

• mmx_image/ — Imágenes

• mmx_video/ — Videos

• mmx_music/ — Música

• mmx_speech/ — Voz

Si deseas colocarlos en otra ubicación, puedes modificarlo mediante la variable de entorno MMX_OUTPUT_DIR:

{
  "mcpServers": {
    "mmx": {
      "command": "node",
      "args": ["/path/to/mmx-mcp-server/dist/index.js"],
      "env": {
        "MINIMAX_API_KEY": "sk-xxxxx",
        "MMX_OUTPUT_DIR": "/Users/xxx/Downloads/mmx-output"
      }
    }
  }
}

No configurar MMX_OUTPUT_DIR no afecta en absoluto al uso; los archivos se guardarán automáticamente en el directorio del proyecto actual.

También puedes especificar la ruta de salida de un archivo individual mediante el parámetro out en cada llamada.

Herramientas proporcionadas

Ejemplos de uso

Una vez configurado, puedes decir directamente en Claude Code:

"Ayúdame a buscar las últimas noticias sobre MiniMax" "Analiza este diseño de interfaz y dame sugerencias de optimización" "Genera una imagen de una escena nocturna de ciudad con estilo cyberpunk" "Convierte este texto a voz"