MiniMax

v1.0.0Data Science & MLstable

Official MiniMax Model Context Protocol (MCP) JavaScript implementation that provides seamless integration with MiniMax's powerful AI capabilities including image generation, video generation, text-to-speech, and voice cloning APIs.

image-generationmcpmcp-servermcp-toolsminimax
Share:
123
Stars
0
Downloads
0
Weekly
0/5

What is MiniMax?

MiniMax is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to official minimax model context protocol (mcp) javascript implementation that provides seamless integration with minimax's powerful ai capabilities including image generation, video generation, text-to...

Official MiniMax Model Context Protocol (MCP) JavaScript implementation that provides seamless integration with MiniMax's powerful AI capabilities including image generation, video generation, text-to-speech, and voice cloning APIs.

This server falls under the Data Science & ML category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • text_to_audio
  • list_voices
  • play_audio
  • voice_clone
  • text_to_image

Use Cases

Generate images, videos, and speech using MiniMax APIs.
Clone voices and perform text-to-speech synthesis.
MiniMax-AI

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y minimax-mcp-js

Manual Installation

npx -y minimax-mcp-js

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MiniMax

MiniMax MCP JS is the official JavaScript/TypeScript MCP server for MiniMax's AI media generation platform, providing Claude and other AI assistants with tools to convert text to speech, generate images, create videos, clone voices, compose music, and design new voice characters — all through the MiniMax API. Files are saved locally to the output directory you configure, making it straightforward to produce media assets directly from a Claude conversation. It is the go-to integration for developers and creatives who want to use MiniMax's multimodal generation APIs without writing API client code.

Prerequisites

  • A MiniMax account with an API key from platform.minimaxi.chat (global) or platform.minimax.chat (mainland China)
  • Node.js 18 or later with npx available
  • An MCP-compatible client such as Claude Desktop or Claude Code
  • Sufficient MiniMax API credits for the media types you plan to generate
1

Obtain a MiniMax API key

Sign up at https://platform.minimaxi.chat (global) or https://platform.minimax.chat (mainland China) and create an API key from the developer console.

2

Install via Smithery (recommended)

Smithery handles installation and Claude Desktop configuration automatically. Run this command and follow the prompts to enter your API key.

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

Alternatively, configure manually

If you prefer manual setup, add the server to claude_desktop_config.json with your API key and preferred output directory. The server is run directly via npx.

4

Set the output directory

By default, generated files are saved to your desktop. Set MINIMAX_MCP_BASE_PATH to an absolute path where you want image, audio, and video files to be written.

5

Restart Claude Desktop and test

After saving the configuration, restart Claude Desktop. Ask Claude to generate a short audio clip or image to confirm the MiniMax API key is valid and the tools are accessible.

MiniMax Examples

Client configuration

Manual claude_desktop_config.json entry for MiniMax MCP JS. Use the global API host (minimaxi.chat with an extra 'i') unless you are in mainland China.

{
  "mcpServers": {
    "minimax-mcp-js": {
      "command": "npx",
      "args": ["-y", "minimax-mcp-js"],
      "env": {
        "MINIMAX_API_KEY": "your_minimax_api_key",
        "MINIMAX_API_HOST": "https://api.minimaxi.chat",
        "MINIMAX_MCP_BASE_PATH": "/Users/yourname/Desktop",
        "MINIMAX_RESOURCE_MODE": "local"
      }
    }
  }
}

Prompts to try

These prompts exercise the eight tools exposed by MiniMax MCP JS — TTS, image generation, video generation, voice cloning, and music generation.

- "Convert this paragraph to speech in a calm, professional female voice and save it as intro.mp3."
- "Generate a photorealistic image of a mountain lake at sunset, 16:9 aspect ratio."
- "Clone my voice from the file /Users/me/voice-sample.wav and use it to read this script."
- "Create a 5-second video of waves crashing on a beach."
- "Generate background music for a lo-fi study session with the prompt: 'calm, piano, 80 BPM'."

Troubleshooting MiniMax

API calls fail with authentication errors even though the key looks correct

Double-check which API host your account uses. Global accounts use https://api.minimaxi.chat (note the extra 'i' in minimaxi). Mainland China accounts use https://api.minimax.chat. Using the wrong host will return auth failures.

Generated files are not appearing anywhere on disk

Set MINIMAX_MCP_BASE_PATH to an absolute directory path you have write access to. If unset, the server defaults to the user's desktop — verify that path exists and is writable.

Video generation times out or never returns

Video generation is asynchronous. Use the query_video_generation tool with the task ID returned by generate_video to poll for completion. Large videos may take several minutes.

Frequently Asked Questions about MiniMax

What is MiniMax?

MiniMax is a Model Context Protocol (MCP) server that official minimax model context protocol (mcp) javascript implementation that provides seamless integration with minimax's powerful ai capabilities including image generation, video generation, text-to-speech, and voice cloning apis. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MiniMax?

Install via npm with the command: npx -y minimax-mcp-js. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with MiniMax?

MiniMax works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MiniMax free to use?

Yes, MiniMax is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Data Science & ML MCP Servers

Explore all data science & ml servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "minimax-mcp-js": { "command": "npx", "args": ["-y", "minimax-mcp-js"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MiniMax?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides