MCP Servers

MiniMax MCP JS

JavaScript implementation of MiniMax MCP that enables interaction with MiniMax AI services for image generation, video generation, text-to-speech, and voice cloning through MCP-compatible clients.

README

export

MiniMax MCP JS

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

</div>

Documentation

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

Features

Text-to-Speech (TTS)
Image Generation
Video Generation
Voice Cloning
Dynamic configuration (supports both environment variables and request parameters)
Compatible with MCP platform hosting (ModelScope, MCP SO, etc.)

Installation

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

Quick Start

MiniMax MCP JS implements the Model Context Protocol (MCP) specification and can be used as a server to interact with MCP-compatible clients (such as Claude AI).

Quickstart with MCP Client

Get your API key from MiniMax International Platform.
Install the package using pnpm: pnpm add minimax-mcp-js

Using with MCP Clients (Recommended)

Install the CLI tool globally:

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

Configure your MCP client:

Claude Desktop

Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include:

{
  "mcpServers": {
    "minimax-mcp-js": {
      "command": "npx",
      "args": [
        "minimax-mcp-js"
      ],
      "env": {
        "MINIMAX_API_KEY": "<your-api-key-here>",
        "MINIMAX_MCP_BASE_PATH": "<local-output-dir-path>",
        "MINIMAX_API_HOST": "https://api.minimaxi.chat",
        "MINIMAX_API_RESOURCE_MODE": "url"
      }
    }
  }
}

Cursor

Go to Cursor → Preferences → Cursor Settings → MCP → Add new global MCP Server to 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 this discussion thread.

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

For local development: When developing locally, you can use npm link to test your changes:

# In your project directory
npm link

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

Configuration

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 the meta.auth object in the request parameters:

{
  "params": {
    "meta": {
      "auth": {
        "api_key": "your_api_key_here",
        "api_host": "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.

2. API Configuration

When used as a module in other projects, you can pass configuration through the startMiniMaxMCP function:

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. Command Line Arguments

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)
MINIMAX_API_HOST=https://api.minimaxi.chat

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

Configuration Parameters

Parameter	Description	Default Value
apiKey	MiniMax API Key	None (Required)
apiHost	MiniMax API Host	https://api.minimaxi.chat
basePath	Base path for output files	User's desktop
resourceMode	Resource handling mode, 'url' or 'local'	url

⚠️ 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

Example usage

⚠️ Warning: Using these tools may incur costs.

1. broadcast a segment of the evening news

2. clone a voice

3. generate a video

4. generate images

Available Tools

Text to Audio

Convert text to speech audio file.

Parameters:

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: Language boost, default is 'auto'
latexRead: Enable LaTeX formula reading
pronunciationDict: Pronunciation dictionary
stream: Enable streaming output
subtitleEnable: Enable subtitle generation
outputDirectory: Directory to save the output file (optional)
outputFile: Path to save the output file (optional, auto-generated if not provided)

Text to Image

Generate images based on text prompts.

Parameters:

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 (optional)
outputFile: Path to save the output file (optional, auto-generated if not provided)

Generate Video

Generate videos based on text prompts.

Parameters:

prompt: Video description (required)
model: Model version, options are 'T2V-01', 'T2V-01-Director', 'I2V-01', 'I2V-01-Director', 'I2V-01-live', 'S2V-01', default is 'T2V-01'
firstFrameImage: Path to first frame image (optional)
outputDirectory: Directory to save the output file (optional)
outputFile: Path to save the output file (optional, auto-generated if not provided)

Voice Clone

Clone a voice from an audio file.

Parameters:

audioFile: Path to audio file (required)
voiceId: Voice ID (required)
text: Text for demo audio (optional)
outputDirectory: Directory to save the output file (optional)

Development

Setup

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

# Install dependencies
pnpm install

Build

# Build the project
pnpm run build

Run

# Run the MCP server
pnpm start

License

MIT

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official

Featured