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驱动的有声书制作 - 同时生成多个章节，支持不同音色的角色配音
🖼️ 网站素材批量生成 - 为网页项目创建统一风格的视觉和音频元素
🎯 多媒体内容流水线 - 完美适配需要图文音并茂的LLM驱动内容工作流

架构优势：

1. 提交阶段：工具立即返回任务ID，任务在后台执行
2. 智能限速：自适应速率限制（图像10 RPM，语音20 RPM）支持突发容量
3. 屏障同步：task_barrier等待所有任务并返回综合结果
4. 批量优化：提交多个任务以饱和速率限制，然后一次屏障获得最大吞吐量

架构

sequenceDiagram
    participant User as 用户
    participant MCP as MCP服务器
    participant TM as 任务管理器
    participant API as Minimax API

    Note over User, API: 异步提交-屏障模式

    User->>MCP: submit_image_generation(prompt1)
    MCP->>TM: submitImageTask()
    TM-->>MCP: taskId: img-001
    MCP-->>User: "任务 img-001 已提交"
    
    par 后台执行（速率限制）
        TM->>API: POST /image/generate
        API-->>TM: 图像数据 + 保存文件
    end

    User->>MCP: submit_speech_generation(text1)
    MCP->>TM: submitTTSTask()
    TM-->>MCP: taskId: tts-002
    MCP-->>User: "任务 tts-002 已提交"
    
    par 后台执行（速率限制）
        TM->>API: POST /speech/generate
        API-->>TM: 音频数据 + 保存文件
    end

    User->>MCP: submit_image_generation(prompt2)
    MCP->>TM: submitImageTask()
    TM-->>MCP: taskId: img-003
    MCP-->>User: "任务 img-003 已提交"

    par 后台执行（速率限制）
        TM->>API: POST /image/generate (排队)
        API-->>TM: 图像数据 + 保存文件
    end

    User->>MCP: task_barrier()
    MCP->>TM: barrier()
    TM->>TM: 等待所有任务
    TM-->>MCP: 结果摘要
    MCP-->>User: ✅ 所有任务已完成<br/>文件可在指定路径获取

    Note over User, API: 立即任务提交 + 后台速率限制执行

工具

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

等待任务完成 - 等待所有已提交的任务完成并检索结果。对于批处理至关重要。

许可证

MIT