MiniMax MCP

強力なテキスト読み上げおよび動画／画像生成 API を利用できる、MiniMax 公式の Model Context Protocol（MCP）サーバーです。このサーバーを使うと、Claude Desktop、Cursor、Windsurf、OpenAI Agents などの MCP クライアントから、音声の生成、音声のクローン作成、動画の生成、画像の生成などを行えます。

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

ドキュメント

• 中国語ドキュメント
• MiniMax-MCP-JS - MiniMax MCP の公式 JavaScript 実装

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

1. MiniMax から API キーを取得します。
2. uv（Python パッケージマネージャー）をインストールします。curl -LsSf https://astral.sh/uv/install.sh | sh でインストールするか、追加のインストール方法については uv のリポジトリを参照してください。
3. 重要：API ホストとキーはリージョンによって異なるため、一致させる必要があります。一致しない場合、Invalid API key エラーが発生します。

リージョン	グローバル	中国本土
MINIMAX_API_KEY	MiniMax Global から取得	MiniMax から取得
MINIMAX_API_HOST	https://api.minimax.io	https://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 種類のトランスポートに対応しています。

stdio	SSE
ローカルで実行	ローカルまたはクラウドにデプロイ可能
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：新しい voice_design ツール。説明的なプロンプトとプレビュー音声からカスタム音声を作成できます
• 動画の強化：超高精細な画質と再生時間／解像度の調整に対応する MiniMax-Hailuo-02 モデルを追加

📈 ツールの強化

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

FAQ

1. API キーが無効です

API キーと API ホストが同じリージョンに対応していることを確認してください。

リージョン	グローバル	中国本土
MINIMAX_API_KEY	MiniMax Global から取得してください	MiniMax から取得してください
MINIMAX_API_HOST	https://api.minimax.io	https://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. 画像を生成する