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

公式のMiniMax Model Context Protocol(MCP)サーバーで、強力なテキスト読み上げおよび動画・画像生成APIとの連携を可能にします。このサーバーにより、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エラーが発生します。
| 地域 | グローバル | 中国本土 |
|---|---|---|
| MINIMAP_API_KEY | MiniMax Globalから取得 | MiniMaxから取得 |
| MINIMAP_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で「開発者モード」を有効にする必要があります。左上のハンバーガーメニューの「ヘルプ」をクリックし、「開発者モードを有効にする」を選択してください。
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 | 動画生成タスクの結果を照会 |
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_KEY | MiniMax Globalから取得 | MiniMaxから取得 |
| MINIMAP_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. 画像を生成
