MiniMax MCP

公式

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

MiniMax MCPで何ができますか?

  • テキスト読み上げ — 指定した音声を使って、書かれたテキストを音声に変換するようアシスタントに依頼します。
  • 音声クローン — 提供した音声ファイルから声をクローンし、その声を音声生成に再利用します。
  • 音声デザイン — 説明的なプロンプトから、プレビュー音声付きのカスタム音声を生成します。
  • 画像生成と編集 — プロンプトから1K/2K/4Kのサイズで画像を作成するか、プロンプトと最大16枚の参照画像を使って画像を編集します。
  • 動画生成 — プロンプトから動画を生成します。長さと解像度を指定でき、後からタスクの結果を照会できます。

ドキュメント

export

強力なテキスト読み上げおよび動画・画像生成APIを利用できる、公式のMiniMax Model Context Protocol(MCP)サーバーです。このサーバーを使うと、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で「Developer Mode」を有効にする必要があります。左上のハンバーガーメニューから「Help」をクリックし、「Enable Developer Mode」を選択してください。

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プロンプトから画像を生成。デフォルトはMiniMax-H3-Image(area 1K/2K/4Kおよびsizeに対応)。image-01もmodel経由で引き続き利用可能
image_editプロンプトと1~16枚の参照画像を使ってMiniMax-H3-Imageで画像を編集
query_video_generation動画生成タスクの結果を照会
voice_designプレビュー用テキストを使ってプロンプトから音声を生成

リリースノート

2026年11月10日

🆕 新機能

  • 画像編集:新しいimage_editツール — プロンプトと1~16枚の参照画像(URL、データURI、mm_file://、またはローカルパス)を使ってMiniMax-H3-Imageで画像を編集
  • H3画像生成:text_to_imageのデフォルトがMiniMax-H3-Imageになり、area(1K/2K/4K)およびsizeに対応。image-01は引き続きmodelパラメーターで利用可能

📈 ツールの強化

  • text_to_image - デフォルトはMiniMax-H3-Image(/v1/images/generations)。以前のモデルを使うにはmodel="image-01"を指定

2025年7月2日

🆕 新機能

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

📈 ツールの強化

  • voice_design - テキストの説明からパーソナライズされた音声を生成
  • generate_video - MiniMax-Hailuo-02に対応。再生時間は6秒/10秒、解像度は768P/1080Pから選択可能

FAQ

1. APIキーが無効

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. 画像を生成する