ミニマックス MCP JS

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

ドキュメント

• 中国語の文書

• Python バージョン- MiniMax MCP の公式 Python 実装

Related MCP server: browser-mcp

特徴

• テキスト読み上げ（TTS）

• 画像生成

• ビデオ生成

• 音声クローン

• 動的構成（環境変数とリクエストパラメータの両方をサポート）

• MCP プラットフォーム ホスティング (ModelScope およびその他の MCP プラットフォーム) と互換性があります

インストール

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

クイックスタート

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

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

1. MiniMax International Platformから API キーを取得します。

2. Node.jsとnpmがすでにインストールされていることを確認してください

3. 重要: API HOST&KEY はリージョンごとに異なります。一致する必要があります。一致しない場合は、 Invalid API keyエラーが発生します。

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 つのトランスポート モードをサポートしています。

構成

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. コマンドライン引数

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

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

2. 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

構成の優先順位

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

1. リクエストレベルの構成（各 API リクエストのmeta.auth経由）

2. コマンドライン引数

3. 環境変数

4. 設定ファイル

5. デフォルト値

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

構成パラメータ

⚠️注意：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

ライセンス

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