Minimax MCP 工具

Minimax AI 集成的 Model Context Protocol (MCP) 服务器，提供异步图像生成和文本转语音功能，并具有高级速率限制和错误处理机制。

English | 简体中文

MCP 配置

添加到您的 MCP 设置中：

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

异步设计 - 完美适用于大规模内容生产

此 MCP 服务器采用异步提交和屏障模式，专为批量内容创建设计：

🎬 配音幻灯片制作 - 并行生成数十张幻灯片图像及其对应的旁白
📚 AI 驱动有声书创作 - 同时生成多个角色声音的章节
🖼️ 网站资产生成 - 为网络项目创建一致的视觉内容和音频元素
🎯 多媒体内容流水线 - 适合需要视觉和音频的大型语言模型驱动的内容工作流程

架构优势：

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 用户
    participant MCP as MCP 服务器
    participant TM as 任务管理器
    participant API as Minimax API

    Note over 用户, API: 异步提交和屏障模式

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

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

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

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

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

    Note over 用户, API: 即时任务提交 + 背景速率限制执行

许可证

MIT