minimax-mcp-js MCP Server

JavaScript/TypeScript implementation of MiniMax MCP, providing image generation, video generation, text-to-speech, and more.

Local serverstdioMIT

What is the minimax-mcp-js MCP Server?

minimax-mcp-js is an MCP project maintained in the minimax-ai/minimax-mcp-js repository. The maintainer describes its purpose as “JavaScript/TypeScript implementation of MiniMax MCP, providing image generation, video generation, text-to-speech, and more”. Read the project documentation for the complete scope.

Installation

The documented npm package is minimax-mcp-js. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares MINIMAX_API_HOST, MINIMAX_API_KEY, MINIMAX_MCP_BASE_PATH, MINIMAX_RESOURCE_MODE. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
textText for demo audio (optional)
voiceIdThe id of the voice to use. For example, "male-qn-qingse"/"audiobook_female_1"/"cute_boy"/"Charming_Lady"... (optional)
speedSpeech speed, range 0.5-2.0, default is 1.0
volVolume, range 0.1-10.0, default is 1.0
pitchPitch, range -12 to 12, default is 0
emotionEmotion, options are 'happy', 'sad', 'angry', 'fearful', 'disgusted', 'surprised', 'neutral', default is 'happy'. Note: This parameter only works with…
formatAudio format, options are 'mp3', 'pcm', 'flac', 'wav', default is 'mp3'
sampleRateSample rate (Hz), options are 8000, 16000, 22050, 24000, 32000, 44100, default is 32000
bitrateBitrate (bps), options are 64000, 96000, 128000, 160000, 192000, 224000, 256000, 320000, default is 128000
channelAudio channels, options are 1 or 2, default is 1
languageBoostEnhance the ability to recognize specified languages and dialects.
streamEnable streaming output
subtitleEnableThe parameter controls whether the subtitle service is enabled. The model must be 'speech-01-turbo' or 'speech-01-hd'. If this parameter is not provided, the…
outputDirectoryThe directory to save the output file. outputDirectory is relative to MINIMAX_MCP_BASE_PATH (or basePath in config). The final save path is…
outputFilePath to save the output file (optional, auto-generated if not provided)
inputFilePathPath to the audio file to play (required)
isUrlWhether the audio file is a URL, default is false
audioFilePath to audio file (required)
promptThe prompt to generate the voice from. (required)
aspectRatioAspect ratio, default is '1:1', options are '1:1', '16:9','4:3', '3:2', '2:3', '3:4', '9:16', '21:9'
promptOptimizerWhether to optimize the prompt, default is true
subjectReferencePath to local image file or public URL for character reference (optional)
asyncModeWhether to use async mode. Defaults to False. If True, the video generation task will be submitted asynchronously and the response will return a task_id.…
firstFrameImagePath to first frame image (optional)
durationThe duration of the video. The model must be "MiniMax-Hailuo-02". Values can be 6 and 10. (optional)
resolutionThe resolution of the video. The model must be "MiniMax-Hailuo-02". Values range ["768P", "1080P"]. (optional)
taskIdThe Task ID to query. Should be the task_id returned by generate_video tool if async_mode is True. (required)
previewTextThe text to preview the voice. (required)

How to install the minimax-mcp-js MCP Server

{
  "mcpServers": {
    "minimax-mcp-js": {
      "command": "npx",
      "args": [
        "-y",
        "minimax-mcp-js"
      ],
      "env": {
        "MINIMAX_API_HOST": "<https://api.minimaxi.chat|https://api.minimax.chat>",
        "MINIMAX_API_KEY": "YOUR_MINIMAX_API_KEY",
        "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>"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
MINIMAX_API_HOSTDeclared in the maintainer’s client configuration.Check documentation
MINIMAX_API_KEYDeclared in the maintainer’s client configuration.Check documentation
MINIMAX_MCP_BASE_PATHDeclared in the maintainer’s client configuration.Check documentation
MINIMAX_RESOURCE_MODEDeclared in the maintainer’s client configuration.Optional