Minimax MCP Tools

Integrations

  • Supports reading LaTeX formulas in text-to-speech functionality with configurable options for pronunciation.

  • Required as a runtime environment for the MCP server with version 16 or higher needed as a prerequisite.

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, "outputFile": "/absolute/path/to/image.jpg", "subjectReference": "/path/to/reference.jpg" // Optional: local file or URL }

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:

// Example parameters for text-to-speech { "text": "Hello, this is a test of the text-to-speech functionality.", "model": "speech-02-hd", "voiceId": "female-shaonv", "speed": 1.0, "volume": 1.0, "pitch": 0, "emotion": "happy", "format": "mp3", "outputFile": "/absolute/path/to/audio.mp3", "subtitleEnable": true }
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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An MCP server implementation that integrates with Minimax API to provide AI-powered image generation and text-to-speech functionality in editors like Windsurf and Cursor.

  1. Features
    1. Setup
      1. Prerequisites
      2. Configuration
    2. MCP Interface
      1. Image Generation
      2. Text-to-Speech
    3. License
      1. Contributing
        1. Acknowledgements

          Related MCP Servers

          • A
            security
            A
            license
            A
            quality
            A MCP server that enables Claude and other MCP-compatible assistants to generate images from text prompts using Together AI's image generation models.
            Last updated -
            1
            2
            TypeScript
            MIT License
            • Apple
            • Linux
          • -
            security
            A
            license
            -
            quality
            A MCP server that integrates with Cursor IDE to generate images based on text descriptions using JiMeng AI, allowing users to create and save custom images directly within their development environment.
            Last updated -
            82
            Python
            MIT License
            • Apple
            • Linux
          • A
            security
            A
            license
            A
            quality
            An MCP Server that integrates with Stability AI's API to provide high-quality image generation, editing, and manipulation capabilities including background removal, outpainting, search-and-replace, and upscaling.
            Last updated -
            13
            35
            55
            TypeScript
            MIT License
            • Apple
          • -
            security
            A
            license
            -
            quality
            An MCP server that connects to Pollinations.ai API, enabling AI models to generate and download images and text through natural language commands.
            Last updated -
            2
            JavaScript
            Apache 2.0
            • Apple
            • Linux

          View all related MCP servers

          ID: urpa6fr1dl