MiniMax MCP JS

by minimax-ai

123 stars
1k downloads
Not rated
GitHub Website

About

A JavaScript/TypeScript server for MiniMax MCP, offering image/video generation, text-to-speech, and voice cloning.

Details

Author
minimax-ai
GitHub stars
123
Downloads
1,047
Categories
Developer Tools, Other, AI, Media
Tags
#content-creation, #audio, #video, #text-to-speech

Jump to

- Text‑to‑Speech (TTS) generation
- Image generation from text prompts
- Video generation (supports MiniMax-Hailuo-02 model)
- Voice cloning and custom voice design
- Music generation (powered by music‑1.5 model)
- Dynamic configuration via environment variables, request parameters, or CLI args
- Compatible with MCP platform hosting (ModelScope and others)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MiniMax MCP JS
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. Request Parameter Configuration (Highest Priority)

In platform hosting environments (like ModelScope or other MCP platforms), you can provide an independent configuration for each request via themeta.authobject in the request parameters:

{ "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" } } } }

This method enables multi-tenant usage, where each request can use different API keys and configurations.

When used as a module in other projects, you can pass configuration through thestartMiniMaxMCPfunction:

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' });

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

- When used as a CLI tool, you can provide configuration via command line arguments:

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

4. Environment Variables (Lowest Priority)

The most basic configuration method is through environment variables:

# 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

When multiple configuration methods are used, the following priority order applies (from highest to lowest):
- Request-level configuration(viameta.authin each API request)
- Command line arguments
- Environment variables
- Configuration file
- Default values

This prioritization ensures flexibility across different deployment scenarios while maintaining per-request configuration capabilities for multi-tenant environments.

⚠️Note: The API key needs to match the host address. Different hosts are used for global and mainland China versions:

- Global Host:https://api.minimaxi.chat(note the extra "i")
- Mainland China Host:https://api.minimax.chat

⚠️ Warning: Using these tools may incur costs.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "minimax mcp js": {
            "MiniMax-MCP-JS": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@MiniMax-AI/MiniMax-MCP-JS",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

McpServers

{
    "MiniMax-MCP-JS": {
        "command": "npx",
        "args": [
            "-y",
            "@smithery/cli",
            "install",
            "@MiniMax-AI/MiniMax-MCP-JS",
            "--client",
            "claude"
        ]
    }
}

JavaScript/TypeScript implementation of MiniMax MCP, providing image generation, video generation, text-to-speech, and more.

- 中文文档
- Python Version- Official Python implementation of MiniMax MCP

- TTS Tool Fixes: Fixed parameter handling forlanguageBoostandsubtitleEnablein thetext_to_audiotool
- API Response Enhancement: TTS API can return both audio file and subtitle file, providing a more complete speech-to-text experience

- Voice Design: Newvoice_designtool - create custom voices from descriptive prompts with preview audio
- Video Enhancement: AddedMiniMax-Hailuo-02model with ultra-clear quality and duration/resolution controls

- voice_design- Generate personalized voices from text descriptions
- generate_video- Now supports MiniMax-Hailuo-02 with 6s/10s duration and 768P/1080P resolution options

- Text-to-Speech (TTS)
- Image Generation
- Video Generation
- Voice Cloning
- Voice Design
- Dynamic configuration (supports both environment variables and request parameters)
- Compatible with MCP platform hosting (ModelScope and other MCP platforms)

To install MiniMax MCP JS for Claude Desktop automatically viaSmithery:

npx -y @smithery/cli install @MiniMax-AI/MiniMax-MCP-JS --client claude

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

MiniMax MCP JS implements theModel Context Protocol (MCP)specification and can be used as a server to interact with MCP-compatible clients (such as Claude AI).
- Get your API key fromMiniMax International Platform.
- Make sure that you already installedNode.js and npm
- Important: API HOST&KEY are different in different region, they must match, otherwise you will receive anInvalid API keyerror.

Go toClaude > Settings > Developer > Edit Config > claude_desktop_config.jsonto include:

{ "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>" } } } }

Go toCursor → Preferences → Cursor Settings → MCP → Add new global MCP Serverto add the above config.

⚠️Note: If you encounter a "No tools found" error when using MiniMax MCP JS with Cursor, please update your Cursor to the latest version. For more information, see thisdiscussion thread.

That's it. Your MCP client can now interact with MiniMax through these tools.

For local development: When developing locally, you can usenpm linkto test your changes:

Then configure Claude Desktop or Cursor to use npx as shown above. This will automatically use your linked version.

⚠️Note: The API key needs to match the host address. Different hosts are used for global and mainland China versions:

- Global Host:https://api.minimaxi.chat(note the extra "i")
- Mainland China Host:https://api.minimaxi.chat

MiniMax MCP JS supports three transport modes:

MiniMax-MCP-JS provides multiple flexible configuration methods to adapt to different use cases. The configuration priority from highest to lowest is as follows:

1. Request Parameter Configuration (Highest Priority)

In platform hosting environments (like ModelScope or other MCP platforms), you can provide an independent configuration for each request via themeta.authobject in the request parameters:

{ "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" } } } }

This method enables multi-tenant usage, where each request can use different API keys and configurations.

When used as a module in other projects, you can pass configuration through thestartMiniMaxMCPfunction:

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' });

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

- When used as a CLI tool, you can provide configuration via command line arguments:

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

4. Environment Variables (Lowest Priority)

The most basic configuration method is through environment variables:

# 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

When multiple configuration methods are used, the following priority order applies (from highest to lowest):
- Request-level configuration(viameta.authin each API request)
- Command line arguments
- Environment variables
- Configuration file
- Default values

This prioritization ensures flexibility across different deployment scenarios while maintaining per-request configuration capabilities for multi-tenant environments.

⚠️Note: The API key needs to match the host address. Different hosts are used for global and mainland China versions:

- Global Host:https://api.minimaxi.chat(note the extra "i")
- Mainland China Host:https://api.minimax.chat

⚠️ Warning: Using these tools may incur costs.

1. broadcast a segment of the evening news

- text: Text to convert (required)
- model: Model version, options are 'speech-02-hd', 'speech-02-turbo', 'speech-01-hd', 'speech-01-turbo', 'speech-01-240228', 'speech-01-turbo-240228', default is 'speech-02-hd'
- voiceId: Voice ID, default is 'male-qn-qingse'
- speed: Speech speed, range 0.5-2.0, default is 1.0
- vol: Volume, range 0.1-10.0, default is 1.0
- pitch: Pitch, range -12 to 12, default is 0
- emotion: Emotion, options are 'happy', 'sad', 'angry', 'fearful', 'disgusted', 'surprised', 'neutral', default is 'happy'. Note: This parameter only works with 'speech-02-hd', 'speech-02-turbo', 'speech-01-turbo', 'speech-01-hd' models
- format: Audio format, options are 'mp3', 'pcm', 'flac', 'wav', default is 'mp3'
- sampleRate: Sample rate (Hz), options are 8000, 16000, 22050, 24000, 32000, 44100, default is 32000
- bitrate: Bitrate (bps), options are 64000, 96000, 128000, 160000, 192000, 224000, 256000, 320000, default is 128000
- channel: Audio channels, options are 1 or 2, default is 1
- languageBoost: Enhance the ability to recognize specified languages and dialects. Supported values include: 'Chinese', 'Chinese,Yue', 'English', 'Arabic', 'Russian', 'Spanish', 'French', 'Portuguese', 'German', 'Turkish', 'Dutch', 'Ukrainian', 'Vietnamese', 'Indonesian', 'Japanese', 'Italian', 'Korean', 'Thai', 'Polish', 'Romanian', 'Greek', 'Czech', 'Finnish', 'Hindi', 'auto', default is 'auto'
- stream: Enable streaming output
- subtitleEnable: The parameter controls whether the subtitle service is enabled. The model must be 'speech-01-turbo' or 'speech-01-hd'. If this parameter is not provided, the default value is false
- outputDirectory: Directory to save the output file.outputDirectoryis relative toMINIMAX_MCP_BASE_PATH(orbasePathin config). The final save path is${basePath}/${outputDirectory}. For example, ifMINIMAX_MCP_BASE_PATH=~/DesktopandoutputDirectory=workspace, the output will be saved to~/Desktop/workspace/. (optional)
- outputFile: Path to save the output file (optional, auto-generated if not provided)

Play an audio file. Supports WAV and MP3 formats. Does not support video.

- inputFilePath: Path to the audio file to play (required)
- isUrl: Whether the audio file is a URL, default is false

- audioFile: Path to audio file (required)
- voiceId: Voice ID (required)
- text: Text for demo audio (optional)
- outputDirectory: Directory to save the output file.outputDirectoryis relative toMINIMAX_MCP_BASE_PATH(orbasePathin config). The final save path is${basePath}/${outputDirectory}. For example, ifMINIMAX_MCP_BASE_PATH=~/DesktopandoutputDirectory=workspace, the output will be saved to~/Desktop/workspace/. (optional)

- prompt: Image description (required)
- model: Model version, default is 'image-01'
- aspectRatio: Aspect ratio, default is '1:1', options are '1:1', '16:9','4:3', '3:2', '2:3', '3:4', '9:16', '21:9'
- n: Number of images to generate, range 1-9, default is 1
- promptOptimizer: Whether to optimize the prompt, default is true
- subjectReference: Path to local image file or public URL for character reference (optional)
- outputDirectory: Directory to save the output file.outputDirectoryis relative toMINIMAX_MCP_BASE_PATH(orbasePathin config). The final save path is${basePath}/${outputDirectory}. For example, ifMINIMAX_MCP_BASE_PATH=~/DesktopandoutputDirectory=workspace, the output will be saved to~/Desktop/workspace/. (optional)
- outputFile: Path to save the output file (optional, auto-generated if not provided)
- asyncMode: Whether to use async mode. Defaults to False. If True, the video generation task will be submitted asynchronously and the response will return a task_id. Should usequery_video_generationtool to check the status of the task and get the result. (optional)

- prompt: Video description (required)
- model: Model version, options are 'T2V-01', 'T2V-01-Director', 'I2V-01', 'I2V-01-Director', 'I2V-01-live', 'S2V-01', 'MiniMax-Hailuo-02', default is 'MiniMax-Hailuo-02'
- firstFrameImage: Path to first frame image (optional)
- duration: The duration of the video. The model must be "MiniMax-Hailuo-02". Values can be 6 and 10. (optional)
- resolution: The resolution of the video. The model must be "MiniMax-Hailuo-02". Values range ["768P", "1080P"]. (optional)
- outputDirectory: Directory to save the output file.outputDirectoryis relative toMINIMAX_MCP_BASE_PATH(orbasePathin config). The final save path is${basePath}/${outputDirectory}. For example, ifMINIMAX_MCP_BASE_PATH=~/DesktopandoutputDirectory=workspace, the output will be saved to~/Desktop/workspace/. (optional)
- outputFile: Path to save the output file (optional, auto-generated if not provided)
- asyncMode: Whether to use async mode. Defaults to False. If True, the video generation task will be submitted asynchronously and the response will return a task_id. Should usequery_video_generationtool to check the status of the task and get the result. (optional)

Query the status of a video generation task.

- taskId: The Task ID to query. Should be the task_id returned bygenerate_videotool ifasync_modeis True. (required)
- outputDirectory: Directory to save the output file.outputDirectoryis relative toMINIMAX_MCP_BASE_PATH(orbasePathin config). The final save path is${basePath}/${outputDirectory}. For example, ifMINIMAX_MCP_BASE_PATH=~/DesktopandoutputDirectory=workspace, the output will be saved to~/Desktop/workspace/. (optional)

Generate a voice based on description prompts.

- prompt: The prompt to generate the voice from. (required)
- previewText: The text to preview the voice. (required)
- voiceId: The id of the voice to use. For example, "male-qn-qingse"/"audiobook_female_1"/"cute_boy"/"Charming_Lady"... (optional)
- outputDirectory: The directory to save the output file.outputDirectoryis relative toMINIMAX_MCP_BASE_PATH(orbasePathin config). The final save path is${basePath}/${outputDirectory}. For example, ifMINIMAX_MCP_BASE_PATH=~/DesktopandoutputDirectory=workspace, the output will be saved to~/Desktop/workspace/. (optional)

1. How to usegenerate_videoin async-mode

Define completion rules before starting:Alternatively, these rules can be configured in your IDE settings (e.g., Cursor):

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

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Interact with MiniMax's powerful APIs for text-to-speech, voice cloning, and video/image generation.

An AI voice toolkit with TTS, voice cloning, and video translation, now available as an MCP server for smarter agent integration.

Interact with MiniMax's powerful Text-to-Speech, image, and video generation APIs.

AI Video, Image & Audio Generation with over 150 models

Turn any language model into a multimodal powerhouse that can generate images, music, videos and more on the fly. Rostro's tools are designed to be used by language models from the ground up, expanding capabilities with minimal context bloat.

All-in-one AI creative studio — generate videos, images, audio in 11 Indian languages, and 3D models via MCP. Hosted at mcp.arcframe.ai.

Hosted MCP server for AudioPod's audio AI: text-to-speech, voice cloning, music generation, stem and speaker separation, transcription, denoise, and voice conversion.

Official Cannon Studio MCP for AI video, image, 3D, audio, workflow, pricing, model, and developer API guidance.

A server for creating fast and free lipsync videos for digital avatars, supporting both realistic and cartoon styles.

MCP server for AI image, video, voice and music generation, routing prompts to Veo 3.1, Seedance 2.0, Nano Banana 2, GPT-Image-2 and more, from Claude, Cursor, ChatGPT or Codex.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Install

Add to Claude Desktop or Cursor

{
    "mcpServers": {
        "minimax mcp js": {
            "MiniMax-MCP-JS": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@MiniMax-AI/MiniMax-MCP-JS",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

More like this

Similar MCP servers you might find useful

Browse category

Sequential Thinking

Sequential Thinking is an MCP server that provides a tool for dynamic and reflective problem-solving through a structured, step-by-step thinking process. It is…

88.2k
Other

Filesystem

Filesystem is a Node.js server that implements the Model Context Protocol (MCP) for filesystem operations. It enables AI assistants to read, write, and manage…

88.1k
Other