MiniMax MCP
@MiniMax-AI
Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.
Overview
What is MiniMax MCP?
MiniMax MCP is the official Model Context Protocol server from MiniMax. It enables MCP clients (such as Claude Desktop, Cursor, Windsurf, and OpenAI Agents) to interact with MiniMax's powerful Text-to-Speech, voice cloning, video generation, and image generation APIs. It is designed for developers who want to integrate MiniMax's generative AI capabilities into their tools.
How to use MiniMax MCP?
Obtain an API key from MiniMax and install uv (Python package manager). Configure your MCP client (e.g., Claude Desktop or Cursor) with the required environment variables: MINIMAX_API_KEY, MINIMAX_MCP_BASE_PATH, MINIMAX_API_HOST (region-specific), and optionally MINIMAX_API_RESOURCE_MODE. After setup, the client can invoke any of the eight available tools.
Key features of MiniMax MCP
- Convert text to audio using a given voice
- List all available voices
- Clone a voice from provided audio files
- Generate video from a text prompt
- Generate images from a text prompt
- Query video generation task results
- Generate music tracks from a prompt and lyrics
- Design custom voices from descriptive prompts with preview audio
Use cases of MiniMax MCP
- Create a broadcast segment by reading evening news with a synthesized voice
- Clone a specific person's voice for content creation
- Generate a short video from a descriptive prompt
- Produce images or music tracks automatically within a workflow
FAQ from MiniMax MCP
Why do I get an "invalid api key" error?
This occurs when your API key and API host are not regionally aligned. Use https://api.minimax.io for Global keys and https://api.minimaxi.com for Mainland China keys.
What does "spawn uvx ENOENT" mean?
It means uvx is not in your PATH. Run which uvx to find its absolute path (e.g., /usr/local/bin/uvx) and update your MCP client configuration to use that path.
How do I use generate_video in async mode?
You must define completion rules either in a dedicated cursor rule file or in your IDE settings (e.g., Cursor) before starting the video generation task.
What transport types does MiniMax MCP support?
It supports both stdio (local, communicates via stdout, can process local files or URLs) and SSE (can be deployed locally or in the cloud, communicates over network, recommended for cloud deployment with URL inputs).
What runtime and dependencies are required?
You need Python and uv (Python package manager). The server is run via uvx minimax-mcp -y. No other explicit runtime requirements are stated.
