Minimax MCP Tools

A Model Context Protocol (MCP) server implementation with Minimax API integration for AI-powered image generation and text-to-speech functionality.

Features

Image Generation: Generate high-quality images based on text prompts using Minimax's image-01 model
Text-to-Speech (TTS): Convert text to natural-sounding speech with various voice options, emotions, and audio formats
Easy Integration: Seamlessly integrates with Windsurf editor as an MCP server

Setup

Prerequisites

Node.js 16 or higher
A Minimax API key (obtain from Minimax Platform)
Minimax Group ID for TTS functionality

Configuration

Create or update your MCP configuration file:

For Windsurf: ~/.codeium/windsurf/mcp_config.json
For Cursor: ~/.cursor/config/mcp_config.json

Both editors use the same configuration format:

{
  "mcpServers": {
    "minimax-mcp-tools": {
      "command": "npx",
      "args": [
        "minimax-mcp-tools"
      ],
      "env": {
        "MINIMAX_API_KEY": "your-minimax-api-key",
        "MINIMAX_GROUP_ID": "your-minimax-group-id"
      }
    }
  }
}

MCP Interface

Image Generation

Generate images based on text prompts:

// Example parameters for image generation
{
  "prompt": "A mountain landscape at sunset",
  "aspectRatio": "16:9",
  "n": 1,
  "outputDir": "generated-images"
}

Parameters:

prompt (required): Description of the image to generate
aspectRatio (optional): Aspect ratio of the image (default: "1:1", options: "1:1", "16:9", "4:3", "3:2", "2:3", "3:4", "9:16", "21:9")
n (optional): Number of images to generate (default: 1, range: 1-9)
outputDir (optional): Directory to save the generated images (default: "generated-images")

Text-to-Speech

Convert text to speech with various customization options:

// Example parameters for text-to-speech
{
  "text": "Hello, this is a test of the text-to-speech functionality.",
  "model": "speech-01-turbo",
  "voiceId": "female-shaonv",
  "speed": 1.0,
  "volume": 1.0,
  "pitch": 0,
  "emotion": "happy",
  "format": "mp3",
  "outputDir": "generated-audio",
  "subtitleEnable": true
}

Basic Parameters:

text (required): Text to convert to speech (max 10,000 characters)
model (optional): Model version to use (default: "speech-01-turbo", options: "speech-01-turbo", "speech-01-240228", "speech-01-turbo-240228", "speech-01-hd")
outputDir (optional): Directory to save the generated audio (default: "generated-audio")

Voice Settings:

voiceId (optional): Voice ID to use (default: "male-qn-qingse")
speed (optional): Speech speed (default: 1.0, range: 0.5-2.0)
volume (optional): Speech volume (default: 1.0, range: 0.1-10.0)
pitch (optional): Speech pitch (default: 0, range: -12 to 12)
emotion (optional): Emotion of the speech (default: "neutral", options: "happy", "sad", "angry", "fearful", "disgusted", "surprised", "neutral")
timberWeights (optional): Voice mixing settings, allows mixing up to 4 different voices with weights
"timberWeights": [ { "voice_id": "male-qn-qingse", "weight": 70 }, { "voice_id": "female-shaonv", "weight": 30 } ]

Audio Settings:

format (optional): Audio format (default: "mp3", options: "mp3", "pcm", "flac", "wav")
sampleRate (optional): Sample rate in Hz (default: 32000, options: 8000, 16000, 22050, 24000, 32000, 44100)
bitrate (optional): Bitrate for MP3 format (default: 128000, options: 32000, 64000, 128000, 256000)
channel (optional): Number of audio channels (default: 1, options: 1=mono, 2=stereo)

Advanced Features:

latexRead (optional): Whether to read LaTeX formulas (default: false)
pronunciationDict (optional): List of pronunciation replacements
"pronunciationDict": ["处理/(chu3)(li3)", "危险/dangerous"]
stream (optional): Whether to use streaming mode (default: false)
languageBoost (optional): Enhance recognition of specific languages
- Options: "Chinese", "Chinese,Yue", "English", "Arabic", "Russian", "Spanish", "French", "Portuguese", "German", "Turkish", "Dutch", "Ukrainian", "Vietnamese", "Indonesian", "Japanese", "Italian", "Korean", "auto"
subtitleEnable (optional): Whether to enable subtitle generation (default: false)

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgements

Minimax API for providing the AI models
Model Context Protocol for the MCP specification

Integrations