Minimax MCP Tools

by PsychArch

50 stars
256 downloads
Not rated
GitHub

About

Async MCP server with Minimax API integration for image generation and text-to-speech

Details

Author
PsychArch
GitHub stars
50
Downloads
256
Categories
Productivity, Other

- Async submit-and-barrier pattern for batch content creation
- Adaptive rate limiting (10 RPM images, 20 RPM speech) with burst capacity
- Barrier synchronization retrieves all task results at once
- Supports image generation with optional parameters (aspect ratio, custom size, seed, references, style)
- Supports text-to-speech with voice, speed, pitch, emotion, and sound effect options
- Tasks execute in background and return immediately with task IDs

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Minimax MCP Tools
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Add the server to your MCP settings with command: "npx", args: ["minimax-mcp-tools"], and set the MINIMAX_API_KEY environment variable. Use the included tools (submit_image_generation, submit_speech_generation, task_barrier) via the MCP client to submit tasks and wait for results.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "minimax mcp tools": {
            "minimax-mcp-tools": {
                "command": "npx",
                "args": [
                    "minimax-mcp-tools"
                ],
                "env": {
                    "MINIMAX_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

McpServers

{
    "minimax-mcp-tools": {
        "command": "npx",
        "args": [
            "minimax-mcp-tools"
        ],
        "env": {
            "MINIMAX_API_KEY": "your_api_key_here"
        }
    }
}

A Model Context Protocol (MCP) server for Minimax AI integration, providing async image generation and text-to-speech with advanced rate limiting and error handling.

{ "mcpServers": { "minimax-mcp-tools": { "command": "npx", "args": ["minimax-mcp-tools"], "env": { "MINIMAX_API_KEY": "your_api_key_here" } } } }

Async Design - Perfect for Content Production at Scale

This MCP server uses anasynchronous submit-and-barrier patterndesigned forbatch content creation:

🎬Narrated Slideshow Production- Generate dozens of slide images and corresponding narration in parallel
📚AI-Driven Audiobook Creation- Produce chapters with multiple voice characters simultaneously
🖼️Website Asset Generation- Create consistent visual content and audio elements for web projects
🎯Multimedia Content Pipelines- Perfect for LLM-driven content workflows requiring both visuals and audio
- Submit Phase: Tools return immediately with task IDs, tasks execute in background
- Smart Rate Limiting: Adaptive rate limiting (10 RPM images, 20 RPM speech) with burst capacity
- Barrier Synchronization:task_barrierwaits for all tasks and returns comprehensive results
- Batch Optimization: Submit multiple tasks to saturate rate limits, then barrier once for maximum throughput

Submit Image Generation Task- Generate images asynchronously.

Required:prompt,outputFile
Optional:aspectRatio,customSize,seed,subjectReference,style

Submit Speech Generation Task- Convert text to speech asynchronously.

Required:text,outputFile
Optional:highQuality,voiceId,speed,volume,pitch,emotion,format,sampleRate,bitrate,languageBoost,intensity,timbre,sound_effects

Wait for Task Completion- Wait for ALL submitted tasks to complete and retrieve results. Essential for batch processing.

sequenceDiagram participant User participant MCP as MCP Server participant TM as Task Manager participant API as Minimax API Note over User, API: Async Submit-and-Barrier Pattern User->>MCP: submit_image_generation(prompt1) MCP->>TM: submitImageTask() TM-->>MCP: taskId: img-001 MCP-->>User: "Task img-001 submitted" par Background Execution (Rate Limited) TM->>API: POST /image/generate API-->>TM: image data + save file end User->>MCP: submit_speech_generation(text1) MCP->>TM: submitTTSTask() TM-->>MCP: taskId: tts-002 MCP-->>User: "Task tts-002 submitted" par Background Execution (Rate Limited) TM->>API: POST /speech/generate API-->>TM: audio data + save file end User->>MCP: submit_image_generation(prompt2) MCP->>TM: submitImageTask() TM-->>MCP: taskId: img-003 MCP-->>User: "Task img-003 submitted" par Background Execution (Rate Limited) TM->>API: POST /image/generate (queued) API-->>TM: image data + save file end User->>MCP: task_barrier() MCP->>TM: barrier() TM->>TM: wait for all tasks TM-->>MCP: results summary MCP-->>User: ✅ All tasks completed<br/>Files available at specified paths Note over User, API: Immediate Task Submission + Background Rate-Limited Execution

Cinema-grade video production MCP server — 8 tools for recording, editing, effects, captions, TTS, and smart screenshots. Built on ffmpeg + Playwright.

Reads text aloud locally on Windows, macOS, and Linux using the operating system's built-in speech engine. No API key, no account, no special hardware required, and no cloud service — text never leaves the machine.

Generates text-to-speech audio with automatic playback using the Chatterbox TTS model.

A server for text-to-speech (TTS) using the VoiceVox engine.

Generate high-quality text-to-speech and text-to-voice outputs using the DAISYS platform.

Interact with the Anki flashcard app via the AnkiConnect add-on. Supports audio generation and similarity search.

Performs morphological analysis on Japanese text using kuromoji.js.

Trigger macOS notifications, sounds, and text-to-speech from an AI assistant.

A sound tool for MCP-compatible IDEs like Cursor. Plays sounds for events like completion, error, and notification.

A voice-enabled AI personal assistant that integrates multiple tools and services through natural voice interactions using MCP.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.