MiniMax MCP

公式

MiniMaxの強力なテキスト読み上げ、画像、動画生成APIと連携します。

MiniMax MCPで何ができますか?

  • テキスト読み上げ — アシスタントに、選択した音声でtext_to_audioを使用して書き込まれたテキストを自然な音声に変換するよう依頼します。
  • 音声クローン — サンプル音声ファイルをvoice_cloneに提供し、そのクローンされた音声で音声を生成します。
  • カスタム音声デザイン — 自然言語で音声を説明し、voice_designを使用してプレビュー音声付きで作成します。
  • 動画生成 — generate_videoを介してテキストプロンプトから動画を生成し、query_video_generationで進捗を追跡します。
  • 画像作成 — text_to_imageを使用してテキストプロンプトを画像に変換します。
  • 音声ライブラリ — list_voicesで利用可能な音声を閲覧し、プロジェクトに適したものを選択します。

ドキュメント

export

公式のMiniMax Model Context Protocol(MCP)サーバーです。強力なテキスト読み上げ、動画・画像生成APIとの連携を可能にします。このサーバーにより、Claude Desktop、Cursor、Windsurf、OpenAI AgentsなどのMCPクライアントが、音声生成、音声クローン、動画生成、画像生成などを実行できます。

💡 推奨: MiniMax CLI (mmx-cli) — 最新モデルとテキスト、ビジョン、検索などの追加機能を備えた公式コマンドラインツールです。Claude Code、Cursor、OpenClawなどのAIエージェントスキルとして動作します。

ドキュメント

MCPクライアントでのクイックスタート

  1. MiniMaxからAPIキーを取得します。
  2. uv(Pythonパッケージマネージャー)をインストールし、curl -LsSf https://astral.sh/uv/install.sh | shでインストールするか、追加のインストール方法についてはuv リポジトリを参照してください。
  3. 重要: APIホストとキーは地域によって異なり、一致している必要があります。一致しない場合、Invalid API keyエラーが発生します。
地域グローバル中国本土
MINIMAX_API_KEYMiniMax Globalから取得MiniMaxから取得
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

Claude Desktop

Claude > Settings > Developer > Edit Config > claude_desktop_config.jsonに移動し、以下を追加します:

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "insert-your-api-key-here",
        "MINIMAX_MCP_BASE_PATH": "local-output-dir-path, such as /User/xxx/Desktop",
        "MINIMAX_API_HOST": "api host, https://api.minimax.io | https://api.minimaxi.com",
        "MINIMAX_API_RESOURCE_MODE": "optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format"
      }
    }
  }
}

⚠️ 警告: APIキーはホストと一致している必要があります。「API Error: invalid api key」エラーが発生した場合は、APIホストを確認してください:

  • グローバルホスト: https://api.minimax.io
  • 中国本土ホスト: https://api.minimaxi.com

Windowsを使用している場合、MCPサーバーを使用するにはClaude Desktopで「開発者モード」を有効にする必要があります。左上のハンバーガーメニューの「ヘルプ」をクリックし、「開発者モードを有効にする」を選択してください。

Cursor

Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Serverに移動し、上記の設定を追加します。

これで完了です。MCPクライアントは以下のツールを通じてMiniMaxと連携できます:

トランスポート

stdioとsseの2つのトランスポートタイプをサポートしています。

stdioSSE
ローカルで実行ローカルまたはクラウドにデプロイ可能
stdoutを介した通信networkを介した通信
入力: local filesまたは有効なURLリソースの処理をサポート入力: クラウドにデプロイする場合、URLを入力に使用することを推奨

利用可能なツール

ツール説明
text_to_audio指定された音声でテキストを音声に変換
list_voices利用可能なすべての音声を一覧表示
voice_clone提供された音声ファイルを使用して音声をクローン
generate_videoプロンプトから動画を生成
text_to_imageプロンプトから画像を生成
query_video_generation動画生成タスクの結果を照会
voice_designプレビューテキストを使用してプロンプトから音声を生成

リリースノート

2025年7月2日

🆕 新機能

  • 音声デザイン: 新しいvoice_designツール - プレビュー音声付きの説明的なプロンプトからカスタム音声を作成
  • 動画強化: 超高清画質と時間・解像度コントロールを備えたMiniMax-Hailuo-02モデルを追加

📈 強化されたツール

  • voice_design - テキスト説明からパーソナライズされた音声を生成
  • generate_video - 6秒/10秒の時間と768P/1080Pの解像度オプションを備えたMiniMax-Hailuo-02をサポート

FAQ

1. invalid api key

APIキーとAPIホストが地域的に一致していることを確認してください

地域グローバル中国本土
MINIMAX_API_KEYMiniMax Globalから取得MiniMaxから取得
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

2. spawn uvx ENOENT

ターミナルで次のコマンドを実行して、絶対パスを確認してください:

which uvx

絶対パス(例: /usr/local/bin/uvx)を取得したら、そのパスを使用するように設定を更新してください(例: "command": "/usr/local/bin/uvx")。

3. 非同期モードでgenerate_videoを使用する方法

開始する前に完了ルールを定義してください: または、これらのルールはIDE設定(例: Cursor)で構成できます:

使用例

⚠️ 警告: これらのツールを使用するとコストが発生する場合があります。

1. 夜のニュースの一部を放送

2. 音声をクローン

3. 動画を生成

4. 画像を生成