Minimax MCP Tools

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 主導のオーディオブック作成 — 複数の音声キャラクターを使った章を同時に制作
🖼️ ウェブサイト素材の生成 — ウェブプロジェクト向けに、一貫性のあるビジュアルコンテンツと音声要素を作成
🎯 マルチメディアコンテンツのパイプライン — ビジュアルと音声の両方を必要とする、LLM 主導のコンテンツワークフローに最適

アーキテクチャのメリット：

1. 送信フェーズ：ツールはタスク ID をすぐに返し、タスクはバックグラウンドで実行されます
2. スマートなレート制限：バースト容量を備えた適応型レート制限（画像は毎分 10 件、音声は毎分 20 件）
3. バリア同期：task_barrier はすべてのタスクを待機し、包括的な結果を返します
4. バッチ最適化：複数のタスクを送信してレート制限を最大限に活用し、その後 1 回のバリアでスループットを最大化します

ツール

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