MiniMax MCP

Name: MiniMax MCP
Author: MiniMax-AI

@MiniMax-AI

MiniMax MCP について

Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

#text-to-speech #mcp #image-generation #text-to-image #video-generation #image-to-video #voice-cloning #text-to-video #mcp-server #mcp-tools

基本情報

カテゴリ

メディアとデザイン

ライセンス

MIT

ランタイム

python

トランスポート

stdio

公開者

MiniMax-AI

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "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>"
      }
    }
  }
}

ツール

Convert text to audio with a given voice and save the output audio file to a given directory. If no directory is provided, the file will be saved to desktop. If no voice ID is provided, the default voice will be used. Note: This tool calls MiniMax API and may incur costs. Use only when explicitly requested by the user.

List all available voices. Only supported when api_host is https://api.minimax.chat.

Play an audio file. Supports WAV and MP3 formats. Does not support video.

Clone a voice using the provided audio file. New voices will incur costs when first used. Note: This tool calls MiniMax API and may incur costs. Use only when explicitly requested by the user.

Generate images based on text prompts. Note: This tool calls MiniMax API and may incur costs. Use only when explicitly requested by the user.

Generate a video based on text prompts. Note: This tool calls MiniMax API and may incur costs. Use only when explicitly requested by the user.

Generate a video based on an image. Note: This tool calls MiniMax API and may incur costs. Use only when explicitly requested by the user.

Query the status of a video generation task.

概要

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).