Minimax MCP Tools

Minimax MCP 工具

用于集成 Minimax AI 的模型上下文协议（MCP）服务，支持异步图像生成和文本转语音，并提供先进的速率限制和错误处理。

English | 简体中文

MCP 配置

将以下内容添加到 MCP 设置中：

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

异步设计——非常适合大规模内容制作

此 MCP 服务采用异步提交并等待屏障模式，专为批量内容创作设计：

🎬 旁白幻灯片制作——并行生成数十张幻灯片图像及相应旁白
📚 AI 驱动的有声读物创作——同时使用多个语音角色制作章节
🖼️ 网站素材生成——为 Web 项目创建风格统一的视觉内容和音频元素
🎯 多媒体内容流水线——非常适合需要同时生成视觉和音频内容的 LLM 驱动工作流

架构优势：

1. 提交阶段：工具立即返回任务 ID，任务在后台执行
2. 智能速率限制：自适应速率限制（图像每分钟 10 次，语音每分钟 20 次），并支持突发容量
3. 屏障同步：task_barrier 等待所有任务完成并返回全面的结果
4. 批量优化：提交多个任务以充分利用速率限制，然后调用一次屏障以实现最大吞吐量

工具

submit_image_generation

提交图像生成任务——异步生成图像。

必需： prompt、outputFile
可选： aspectRatio、customSize、seed、subjectReference、style

submit_speech_generation

提交语音生成任务——异步将文本转换为语音。

必需： text、outputFile
可选： highQuality、voiceId、speed、volume、pitch、emotion、format、sampleRate、bitrate、languageBoost、intensity、timbre、sound_effects

task_barrier

等待任务完成——等待所有已提交的任务完成并获取结果。对批量处理至关重要。

架构

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

许可证

MIT