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

Related MCP server: Vibe Coder MCP

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:

MCP Interface

Image Generation

Generate images based on text prompts:

Parameters:

• prompt (required): Description of the image to generate

• outputFile (required): Absolute path to save the generated image file. The directory must already exist. When generating multiple images (n>1), files will be named with sequential numbers (e.g., 'image-1.jpg', 'image-2.jpg').

• 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). When n>1, the output filenames will be automatically numbered.

• subjectReference (optional): Path to a local image file or a public URL for character reference. When provided, the generated image will use this as a reference for character appearance. Supported formats: JPG, JPEG, PNG

Text-to-Speech

Convert text to speech with various customization options:

Basic Parameters:

• text (required): Text to convert to speech (max 10,000 characters)

• outputFile (required): Absolute path to save the generated audio file

• model (optional): Model version to use (default: "speech-02-hd", options: "speech-02-hd", "speech-02-turbo")

  • speech-02-hd: High-definition model with excellent timbre similarity, rhythm stability, and studio-grade audio quality

  • speech-02-turbo: Fast model with excellent performance and low latency, enhanced multilingual capabilities

• 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", "Thai", "Polish", "Romanian", "Greek", "Czech", "Finnish", "Hindi", "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