异步内容生成工具

Minimax MCP Tools是一个用于Minimax AI集成的模型上下文协议服务器,提供异步图像生成和文本转语音功能,具有高级速率限制和错误处理能力。

  • by PsychArch
  • TypeScript
  • 本地部署
  • 50 星标
  • 更新于
在 GitHub 查看 PsychArch/minimax-mcp-tools

使用说明

Minimax MCP工具

用于Minimax AI集成的模型上下文协议(MCP)服务器,提供异步图像生成和文本到语音,具有高级速率限制和错误处理功能。

英语| 简体中文

MCP配置

添加到MCP设置中:

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

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

此MCP服务器使用 异步提交和屏障模式 设计用于 批量内容创建:

🎬 解说幻灯片制作 -并行生成数十张幻灯片图像和相应的旁白
📚 人工智能驱动的有声读物创作 -同时生成多个语音字符的章节
🖼️ 网站资产生成 -为web项目创建一致的视觉内容和音频元素
🎯 多媒体内容管道 -非常适合需要视觉和音频的LLM驱动的内容工作流程

架构优势:

  1. 提交阶段:工具立即返回任务ID,任务在后台执行
  2. 智能速率限制:具有突发容量的自适应速率限制(10 RPM图像,20 RPM语音)
  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

许可证

麻省理工学院