ミニマックス MCP JS

MiniMax MCP の JavaScript/TypeScript 実装。画像生成、ビデオ生成、テキスト読み上げなどの機能を提供します。

ドキュメント

中国語の文書
Python バージョン- MiniMax MCP の公式 Python 実装

特徴

テキスト読み上げ（TTS）
画像生成
ビデオ生成
音声クローン
動的構成（環境変数とリクエストパラメータの両方をサポート）
MCP プラットフォームホスティング (ModelScope およびその他の MCP プラットフォーム) と互換性があります

インストール

# Install with pnpm (recommended)
pnpm add minimax-mcp-js

クイックスタート

MiniMax MCP JS は、モデルコンテキストプロトコル (MCP)仕様を実装しており、MCP 互換クライアント (Claude AI など) と対話するためのサーバーとして使用できます。

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

MiniMax International Platformから API キーを取得します。
Node.jsとnpmがすでにインストールされていることを確認してください
重要: API HOST&KEY はリージョンごとに異なります。一致する必要があります。一致しない場合は、 Invalid API keyエラーが発生します。

地域	グローバル	本土
MINIMAX_API_KEY	MiniMax Globalから入手する	MiniMaxから入手する
MINIMAX_API_HOST	https://api.minimaxi.chat (余分な「i」に注意してください)	https://api.minimax.chat

MCP クライアントでの使用 (推奨)

MCP クライアントを構成します。

クロードデスクトップ

Claude > Settings > Developer > Edit Config > claude_desktop_config.jsonに移動して、以下を追加します。

{
  "mcpServers": {
    "minimax-mcp-js": {
      "command": "npx",
      "args": [
        "-y",
        "minimax-mcp-js"
      ],
      "env": {
        "MINIMAX_API_HOST": "<https://api.minimaxi.chat|https://api.minimax.chat>",
        "MINIMAX_API_KEY": "<your-api-key-here>",
        "MINIMAX_MCP_BASE_PATH": "<local-output-dir-path, such as /User/xxx/Desktop>",
        "MINIMAX_RESOURCE_MODE": "<optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format>"
      }
    }
  }
}

カーソル

上記の設定を追加するには、 Cursor → Preferences → Cursor Settings → MCP → Add new global MCP Serverに移動します。

⚠️注意：MiniMax MCP JSをCursorと組み合わせて使用する際に「ツールが見つかりません」というエラーが発生する場合は、Cursorを最新バージョンに更新してください。詳細については、こちらのディスカッションスレッドをご覧ください。

これで完了です。MCP クライアントはこれらのツールを通じて MiniMax とやり取りできるようになりました。

ローカル開発の場合: ローカルで開発する場合は、 npm linkを使用して変更をテストできます。

# In your project directory
npm link

次に、上記のようにClaude DesktopまたはCursorでnpxを使用するように設定します。これにより、リンクされたバージョンが自動的に使用されます。

⚠️注意：APIキーはホストアドレスと一致する必要があります。グローバル版と中国本土版では異なるホストが使用されます。

グローバルホスト: https://api.minimaxi.chat (余分な「i」に注意してください)
中国本土ホスト: https://api.minimaxi.chat

輸送モード

MiniMax MCP JS は、次の 3 つのトランスポートモードをサポートしています。

特徴	stdio（デフォルト）	休む	南南東
環境	ローカルのみ	ローカルまたはクラウド展開	ローカルまたはクラウド展開
コミュニケーション	`standard I/O`経由	`HTTP requests`経由	`server-sent events`経由
ユースケース	ローカルMCPクライアント統合	APIサービス、言語間呼び出し	サーバープッシュを必要とするアプリケーション
入力制限	`local files`または`URL`リソースをサポート	クラウドに展開する場合は`URL`入力を推奨	クラウドに展開する場合は`URL`入力を推奨

構成

MiniMax-MCP-JSは、さまざまなユースケースに適応できるよう、複数の柔軟な設定方法を提供しています。設定の優先順位は、高いものから低いものの順で以下のとおりです。

1. リクエストパラメータの設定（最優先）

プラットフォームホスティング環境 (ModelScope やその他の MCP プラットフォームなど) では、リクエストパラメータのmeta.authオブジェクトを介して、リクエストごとに独立した構成を提供できます。

{
  "params": {
    "meta": {
      "auth": {
        "api_key": "your_api_key_here",
        "api_host": "<https://api.minimaxi.chat|https://api.minimaxi.chat>",
        "base_path": "/path/to/output",
        "resource_mode": "url"
      }
    }
  }
}

この方法により、マルチテナントの使用が可能になり、各リクエストで異なる API キーと構成を使用できるようになります。

2. API設定

他のプロジェクトのモジュールとして使用する場合は、 startMiniMaxMCP関数を通じて構成を渡すことができます。

import { startMiniMaxMCP } from 'minimax-mcp-js';

await startMiniMaxMCP({
  apiKey: 'your_api_key_here',
  apiHost: 'https://api.minimaxi.chat', // Global Host - https://api.minimaxi.chat, Mainland Host - https://api.minimax.chat
  basePath: '/path/to/output',
  resourceMode: 'url'
});

3. コマンドライン引数

CLI ツールをグローバルにインストールします。

# Install globally
pnpm install -g minimax-mcp-js

CLI ツールとして使用する場合は、コマンドライン引数を使用して構成を指定できます。

minimax-mcp-js --api-key your_api_key_here --api-host https://api.minimaxi.chat --base-path /path/to/output --resource-mode url

4. 環境変数（最低優先度）

最も基本的な設定方法は環境変数を使用することです。

# MiniMax API Key (required)
MINIMAX_API_KEY=your_api_key_here

# Base path for output files (optional, defaults to user's desktop)
MINIMAX_MCP_BASE_PATH=~/Desktop

# MiniMax API Host (optional, defaults to https://api.minimaxi.chat, Global Host - https://api.minimaxi.chat, Mainland Host - https://api.minimax.chat)
MINIMAX_API_HOST=https://api.minimaxi.chat

# Resource mode (optional, defaults to 'url')
# Options: 'url' (return URLs), 'local' (save files locally)
MINIMAX_RESOURCE_MODE=url

構成の優先順位

複数の構成方法を使用する場合、次の優先順位が適用されます (最高から最低の順)。

リクエストレベルの構成（各 API リクエストのmeta.auth経由）
コマンドライン引数
環境変数
設定ファイル
デフォルト値

この優先順位付けにより、マルチテナント環境のリクエストごとの構成機能を維持しながら、さまざまな展開シナリオにわたる柔軟性が確保されます。

構成パラメータ

パラメータ	説明	デフォルト値
apiキー	MiniMax APIキー	なし（必須）
apiホスト	MiniMax APIホスト	グローバルホスト - https://api.minimaxi.chat 、本土ホスト - https://api.minimax.chat
ベースパス	出力ファイルのベースパス	ユーザーのデスクトップ
リソースモード	リソース処理モード、「url」または「local」	URL

⚠️注意：APIキーはホストアドレスと一致する必要があります。グローバル版と中国本土版では異なるホストが使用されます。

グローバルホスト: https://api.minimaxi.chat (余分な「i」に注意してください)
中国本土ホスト: https://api.minimax.chat

使用例

⚠️ 警告: これらのツールを使用すると費用が発生する場合があります。

1.夕方のニュースの一部を放送する

2. 声を複製する

3. ビデオを生成する

4. 画像を生成する

利用可能なツール

テキストから音声へ

テキストを音声オーディオファイルに変換します。

ツール名: text_to_audio

パラメータ:

text : 変換するテキスト（必須）
model : モデルバージョン。オプションは「speech-02-hd」、「speech-02-turbo」、「speech-01-hd」、「speech-01-turbo」、「speech-01-240228」、「speech-01-turbo-240228」、デフォルトは「speech-02-hd」
voiceId : 音声ID、デフォルトは「male-qn-qingse」
speed : 音声速度、範囲は 0.5～2.0、デフォルトは 1.0
vol : 音量、範囲は 0.1～10.0、デフォルトは 1.0
pitch : ピッチ、範囲は -12 から 12、デフォルトは 0
emotion ：感情。選択肢は「幸せ」「悲しい」「怒り」「恐れ」「嫌悪」「��き」「中立」で、デフォルトは「幸せ」です。注：このパラメータは「speech-02-hd」「speech-02-turbo」「speech-01-turbo」「speech-01-hd」モデルでのみ機能します。
format : オーディオフォーマット。オプションは「mp3」、「pcm」、「flac」、「wav」、デフォルトは「mp3」
sampleRate : サンプルレート (Hz)、オプションは 8000、16000、22050、24000、32000、44100、デフォルトは 32000
bitrate : ビットレート (bps)、オプションは 64000、96000、128000、160000、192000、224000、256000、320000、デフォルトは 128000
channel : オーディオチャンネル。オプションは1または2、デフォルトは1
languageBoost : 言語ブースト、デフォルトは「自動」
latexRead : LaTeXの数式の読み取りを有効にする
pronunciationDict : 発音辞書
stream : ストリーミング出力を有効にする
subtitleEnable : 字幕生成を有効にする
outputDirectory : 出力ファイルを保存するディレクトリ（オプション）
outputFile : 出力ファイルを保存するパス（オプション、指定されていない場合は自動生成されます）

音声を再生

オーディオファイルを再生します。WAVおよびMP3形式をサポートします。ビデオはサポートしていません。

ツール名: play_audio

パラメータ:

inputFilePath : 再生するオーディオファイルへのパス（必須）
isUrl : オーディオファイルがURLかどうか。デフォルトはfalse

ボイスクローン

オーディオファイルから音声を複製します。

ツール名: voice_clone

パラメータ:

audioFile : オーディオファイルへのパス（必須）
voiceId : 音声ID（必須）
text : デモ音声のテキスト（オプション）
outputDirectory : 出力ファイルを保存するディレクトリ（オプション）

テキストから画像へ

テキストプロンプトに基づいて画像を生成します。

ツール名: text_to_image

パラメータ:

prompt : 画像の説明（必須）
model : モデルバージョン、デフォルトは 'image-01'
aspectRatio : アスペクト比。デフォルトは「1:1」、オプションは「1:1」、「16:9」、「4:3」、「3:2」、「2:3」、「3:4」、「9:16」、「21:9」
n : 生成する画像の数、範囲は1～9、デフォルトは1
promptOptimizer : プロンプトを最適化するかどうか。デフォルトは true
subjectReference : 文字参照用のローカル画像ファイルまたはパブリック URL へのパス (オプション)
outputDirectory : 出力ファイルを保存するディレクトリ（オプション）
outputFile : 出力ファイルを保存するパス（オプション、指定されていない場合は自動生成されます）
asyncMode : 非同期モードを使用するかどうか。デフォルトはFalseです。Trueの場合、ビデオ生成タスクは非同期で送信され、レスポンスとしてtask_idが返されます。タスクのステータスを確認し、結果を取得するには、 query_video_generationツールを使用する必要があります。(オプション)

ビデオを生成する

テキストプロンプトに基づいてビデオを生成します。

ツール名: generate_video

パラメータ:

prompt : ビデオの説明 (必須)
model : モデルバージョン。オプションは「T2V-01」、「T2V-01-Director」、「I2V-01」、「I2V-01-Director」、「I2V-01-live」、「S2V-01」、デフォルトは「T2V-01」
firstFrameImage : 最初のフレーム画像へのパス（オプション）
outputDirectory : 出力ファイルを保存するディレクトリ（オプション）
outputFile : 出力ファイルを保存するパス（オプション、指定されていない場合は自動生成されます）
asyncMode : 非同期モードを使用するかどうか。デフォルトはFalseです。Trueの場合、ビデオ生成タスクは非同期で送信され、レスポンスとしてtask_idが返されます。タスクのステータスを確認し、結果を取得するには、 query_video_generationツールを使用する必要があります。(オプション)

ビデオ生成ステータスのクエリ

ビデオ生成タスクのステータスを照会します。

ツール名: query_video_generation

パラメータ:

taskId : クエリするタスクID。async_mode async_mode Trueの場合、 generate_videoツールによって返されるtask_idである必要があります。(必須)
outputDirectory : 出力ファイルを保存するディレクトリ（オプション）

よくある質問

1. 非同期モードで`generate_video`使用する方法

開始する前に補完ルールを定義します。または、これらのルールは IDE 設定 (カーソルなど) で構成できます。

発達

設定

# Clone the repository
git clone https://github.com/MiniMax-AI/MiniMax-MCP-JS.git
cd minimax-mcp-js

# Install dependencies
pnpm install

建てる

# Build the project
pnpm run build

走る

# Run the MCP server
pnpm start

ライセンス

マサチューセッツ工科大学

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

MiniMax MCP の JavaScript 実装。MCP 互換クライアントを介して、画像生成、ビデオ生成、テキスト読み上げ、音声複製のための MiniMax AI サービスとの対話を可能にします。

Related MCP Servers

Mistral MCP Server
speakeasy-api
-
security
A
license
-
quality
A TypeScript-based MCP server that provides two tools for chatting with Mistral AI models, supporting both text-only conversations and image+text inputs.
Last updated -
JavaScript
MIT License
Minimax MCP Tools
PsychArch
A
security
A
license
A
quality
An MCP server implementation that integrates with Minimax API to provide AI-powered image generation and text-to-speech functionality in editors like Windsurf and Cursor.
Last updated -
2
16
49
JavaScript
MIT License
browser-mcp
djyde
-
security
F
license
-
quality
A MCP server that allows AI assistants to interact with the browser, including getting page content as markdown, modifying page styles, and searching browser history.
Last updated -
79
TypeScript
MiniMax MCP Serverofficial
MiniMax-AI
A
security
A
license
A
quality
Enables MCP clients like Claude Desktop and Cursor to interact with MiniMax APIs for generating speech, cloning voices, creating videos, and generating images.
Last updated -
6
862
Python
MIT License

View all related MCP servers