MCP Directory

How to add MiniMax MCP Server (Official) to Windsurf

Official MiniMax server for TTS, voice cloning, music, image, and video generation. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 1.5k★ · stdio · apikey · official

Windsurf config for MiniMax MCP Server (Official)

uvx minimax-mcp -y
{
  "mcpServers": {
    "minimax-mcp-server-official": {
      "command": "uvx",
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "<your-api-key>",
        "MINIMAX_API_HOST": "https://api.minimax.io",
        "MINIMAX_MCP_BASE_PATH": "/absolute/path/to/output/dir"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the MiniMax MCP Server (Official) config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5MiniMax MCP Server (Official)'s tools become available to Cascade.

Before you start

  • Python with the uv package manager installed (the server is launched via uvx/uv)
  • A MiniMax API key from your account at the MiniMax platform (platform key page, region-specific)
  • The correct regional API host: https://api.minimax.io (global) or https://api.minimaxi.com (mainland China) — host and key must match the same region
  • A writable local output directory for generated audio/image/video files
  • An MCP-capable client (Claude Desktop, Cursor, Windsurf, etc.)

What MiniMax MCP Server (Official) can do in Windsurf

text_to_audio

Convert text to speech (TTS) with selectable voices and parameters

list_voices

List the available system and cloned voices

voice_clone

Clone a voice from a provided audio sample

voice_design

Generate a custom voice from a natural-language description

music_generation

Generate music tracks (powered by the music-1.5 model)

text_to_image

Generate images from a text prompt

generate_video

Generate video from a text prompt, with duration/resolution controls

query_video_generation

Poll the status of an asynchronous video generation task

Security

Set MINIMAX_API_HOST to match the region where your API key was issued or calls will fail with an invalid-key error; the key bills your MiniMax account. Generated media is written to the configured local base path.

MiniMax MCP Server (Official) + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the MiniMax MCP Server (Official) config there under the "mcpServers" key and restart the client.

Is MiniMax MCP Server (Official) safe to use with Windsurf?

Set MINIMAX_API_HOST to match the region where your API key was issued or calls will fail with an invalid-key error; the key bills your MiniMax account. Generated media is written to the configured local base path.

Why do I get an 'Invalid API key' error?

Almost always a region mismatch: the API host and key must be from the same region. Pair a global key with https://api.minimax.io, or a mainland key with https://api.minimaxi.com.

Where do generated files go?

To the output directory you set in the server configuration; tools return file paths (or URLs) for the generated audio, image, and video assets.

Is video generation synchronous?

No. generate_video starts a job and you poll query_video_generation until the task finishes, then download the result.

View repo Full MiniMax MCP Server (Official) page