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

強力なテキスト読み上げおよび動画・画像生成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クライアントでクイックスタート
- MiniMaxからAPIキーを取得します。
uv(Pythonパッケージマネージャー)をインストールし、curl -LsSf https://astral.sh/uv/install.sh | shでインストールするか、追加のインストール方法についてはuvリポジトリを参照してください。- 重要: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 | プロンプトから画像を生成。デフォルトは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_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. 画像を生成する
