MiniMax
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.
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
Maintainer
Works with
Installation
NPM
npx -y minimax-mcp-jsManual Installation
npx -y minimax-mcp-jsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
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
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.
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 claudeAlternatively, 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.
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.
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.
MiniMax Alternatives — Similar Data Science & ML Servers
Looking for alternatives to MiniMax? Here are other popular data science & ml servers you can use with Claude, Cursor, and VS Code.
Ultrarag
★ 5.6kA Low-Code MCP Framework for Building Complex and Innovative RAG Pipelines
RocketRide
★ 3.1k📇 🏠 - MCP server that exposes RocketRide AI pipelines as t
Aix Db
★ 2.1kAix-DB 基于 LangChain/LangGraph 框架,结合 MCP Skills 多智能体协作架构,实现自然语言到数据洞察的端到端转换。
NeMo Data Designer
★ 1.9k🎨 NeMo Data Designer: Generate high-quality synthetic data from scratch or from seed data.
PaperBanana
★ 1.7kOpen source implementation and extension of Google Research’s PaperBanana for automated academic figures, diagrams, and research visuals, expanded to new domains like slide generation.
MiniMax
★ 1.5kBridges MiniMax AI capabilities to the Model Context Protocol, enabling AI agents to perform image understanding, text-to-image generation, and speech synthesis. It provides a standardized interface for accessing MiniMax's core tools via JSON-RPC.
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.
Set Up MiniMax in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
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.