Minimax

Local

minimax.ioMedia & Design0Updated 80w ago

About Minimax

MiniMax is the official MCP server for using MiniMax speech, voice, image, and video generation APIs from compatible clients. It provides tools for text-to-audio, voice listing and cloning, and prompt-based image and video generation.

Key features

01Convert text to audio
02List available voices
03Clone a voice from audio files
04Generate video from a prompt
05Generate images from a prompt

Use cases

01Create spoken audio from text
02Clone a voice using audio files
03Generate video from a prompt
04Generate images from a prompt

MCP support

Exposes MiniMax generation tools to MCP clients over stdio or SSE. Inputs can include local files or URLs over stdio; cloud SSE deployments recommend URL inputs.

#minimax #text-to-speech #video-generation

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "minimax-mcp-ropon": {
      "command": "uvx",
      "args": [
        "minimax-mcp"
      ],
      "env": {
        "MINIMAX_API_KEY": "<MINIMAX_API_KEY>",
        "MINIMAX_MCP_BASE_PATH": "<MINIMAX_MCP_BASE_PATH>",
        "MINIMAX_API_HOST": "<MINIMAX_API_HOST>",
        "MINIMAX_API_RESOURCE_MODE": "<MINIMAX_API_RESOURCE_MODE>"
      }
    }
  }
}

Run commanduvx minimax-mcp

Environment variables to set

MINIMAX_API_KEYSecret

MINIMAX_MCP_BASE_PATH

MINIMAX_API_HOST

MINIMAX_API_RESOURCE_MODE

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

pypiminimax-mcpstdio

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

export

Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech and video/image generation APIs. This server allows MCP clients like Claude Desktop, Cursor, Windsurf, OpenAI Agents and others to generate speech, clone voices, generate video, generate image and more.

Documentation

中文文档
MiniMax-MCP-JS - Official JavaScript implementation of MiniMax MCP

Quickstart with MCP Client

Get your API key from MiniMax.
Install uv (Python package manager), install with curl -LsSf https://astral.sh/uv/install.sh | sh or see the uv repo for additional install methods.

Claude Desktop

Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:

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

⚠️ Warning: The API key needs to match the host. If an error "API Error: invalid api key" occurs, please check your api host:

Global Host：https://api.minimaxi.chat (note the extra "i")
Mainland Host：https://api.minimax.chat

If you're using Windows, you will have to enable "Developer Mode" in Claude Desktop to use the MCP server. Click "Help" in the hamburger menu in the top left and select "Enable Developer Mode".

Cursor

Go to Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server to add above config.

That's it. Your MCP client can now interact with MiniMax through these tools:

Transport

We support two transport types: stdio and sse.

stdio	SSE
Run locally	Can be deployed locally or in the cloud
Communication through `stdout`	Communication through `network`
Input: Supports processing `local files` or valid `URL` resources	Input: When deployed in the cloud, it is recommended to use `URL` for input

Available Tools

tool	description
`text_to_audio`	Convert text to audio with a given voice
`list_voices`	List all voices available
`voice_clone`	Clone a voice using provided audio files
`generate_video`	Generate a video from a prompt
`text_to_image`	Generate a image from a prompt

Example usage

⚠️ Warning: Using these tools may incur costs.

1. broadcast a segment of the evening news

2. clone a voice

3. generate a video

4. generate images

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.