ミニマックス 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 キーを取得します。
pnpm を使用してminimax-mcp-jsをインストールします: pnpm add minimax-mcp-js
重要: 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 クライアントでの使用 (推奨)

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

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

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

クロードデスクトップ

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

{
  "mcpServers": {
    "minimax-mcp-js": {
      "command": "npx",
      "args": [
        "minimax-mcp-js"
      ],
      "env": {
        "MINIMAX_API_HOST": "https://api.minimaxi.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",
        "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',
  basePath: '/path/to/output',
  resourceMode: 'url'
});

3. コマンドライン引数

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)
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
ベースパス	出力ファイルのベースパス	ユーザーのデスクトップ
リソースモード	リソース処理モード、「url」または「local」	URL

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

グローバルホスト: https://api.minimaxi.chat (余分な「i」に注意してください)
中国本土ホスト: https://api.minimaxi.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 : 出力ファイルを保存するパス（オプション、指定されていない場合は自動生成されます）

テキストから画像へ

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

ツール名: 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 : 出力ファイルを保存するパス（オプション、指定されていない場合は自動生成されます）

ビデオを生成する

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

ツール名: generate_video

パラメータ:

prompt : ビデオの説明 (必須)
model : モデルバージョン。オプションは「T2V-01」、「T2V-01-Director」、「I2V-01」、「I2V-01-Director」、「I2V-01-live」、「S2V-01」、デフォルトは「T2V-01」
firstFrameImage : 最初のフレーム画像へのパス（オプション）
outputDirectory : 出力ファイルを保存するディレクトリ（オプション）
outputFile : 出力ファイルを保存するパス（オプション、指定されていない場合は自動生成されます）

ボイスクローン

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

ツール名: voice_clone

パラメータ:

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

発達

設定

# 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

ライセンス

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

Integrations

ミニマックス MCP JS

ドキュメント

特徴

インストール

クイックスタート

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

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

クロードデスクトップ

カーソル

輸送モード

構成

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

2. API設定

3. コマンドライン引数

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

構成の優先順位

構成パラメータ

使用例

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

2. 声を複製する

3. ビデオを生成する

4. 画像を生成する

利用可能なツール

テキストから音声へ

テキストから画像へ

ビデオを生成する

ボイスクローン

発達

設定

建てる

走る

ライセンス