MiniMax MCP

公式

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

MiniMax MCPで何ができますか?

  • テキスト読み上げ — 選択した音声でtext_to_audioを使用し、任意のテキストを自然な音声に変換します。
  • 音声クローン — サンプル音声ファイルからvoice_cloneを使用してカスタム音声を作成し、パーソナライズされたナレーションを実現します。
  • 動画生成generate_videoでテキストプロンプトを動画に変換し、query_video_generationで進捗を確認します。
  • 画像作成text_to_imageで説明的なプロンプトから画像を生成します。
  • 音楽作曲music_generationを使用して、歌詞とプロンプトからオリジナルの音楽トラックを制作します。
  • 音声デザインvoice_designでテキストの説明から独自の音声を作成し、サンプル音声でプレビューできます。

ドキュメント

export

公式のMiniMax Model Context Protocol(MCP)サーバーで、強力なテキスト読み上げおよび動画・画像生成APIとの連携を可能にします。このサーバーにより、Claude DesktopCursorWindsurfOpenAI 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エラーが発生します。
地域グローバル中国本土
MINIMAP_API_KEYMiniMax Globalから取得MiniMaxから取得
MINIMAP_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動画生成タスクの結果を照会
music_generationプロンプトと歌詞から音楽トラックを生成
voice_designプレビューテキストを使用してプロンプトから音声を生成

リリースノート

2025年7月2日

🆕 新機能

  • 音声デザイン: 新しいvoice_designツール - 説明プロンプトからプレビュー音声付きのカスタム音声を作成
  • 動画強化: ウルトラクリア品質と時間・解像度コントロールを備えたMiniMax-Hailuo-02モデルを追加
  • 音楽生成: music-1.5モデルを搭載したmusic_generationツールを強化

📈 強化されたツール

  • voice_design - テキスト説明からパーソナライズされた音声を生成
  • generate_video - 6秒/10秒の時間と768P/1080Pの解像度オプションを備えたMiniMax-Hailuo-02をサポート
  • music_generation - music-1.5モデルによる高品質な音楽作成

FAQ

1. invalid api key

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

地域グローバル中国本土
MINIMAP_API_KEYMiniMax Globalから取得MiniMaxから取得
MINIMAP_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. 画像を生成