MiniMax
Bridges 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.
What is MiniMax?
MiniMax is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to bridges 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 f...
Bridges 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.
This server falls under the Data Science & ML category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Bridges MiniMax AI capabilities to the Model Context Protoco
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx minimax-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MiniMax
The MiniMax MCP server bridges MiniMax AI's multimodal generation capabilities—text-to-image, text-to-video, text-to-speech, voice cloning, and music generation—to any MCP-compatible AI client via a standardized JSON-RPC interface. It is published as the `minimax-mcp` Python package and runs via `uvx`, requiring only a MiniMax API key to get started. AI assistants connected to it can generate media assets, synthesize speech with custom voices, clone voices from audio samples, and compose music, all from natural language prompts.
Prerequisites
- uv Python package manager installed (`curl -LsSf https://astral.sh/uv/install.sh | sh`)
- A MiniMax API key from api.minimax.io (Global) or api.minimaxi.com (Mainland China)
- An MCP-compatible client such as Claude Desktop or Cursor
- Sufficient disk space or a writable output directory for generated media files
- On Windows: Developer Mode enabled in Claude Desktop settings
Obtain a MiniMax API key
Sign up at the MiniMax platform matching your region. Global users register at api.minimax.io; Mainland China users use api.minimaxi.com. The API key and host must match your region or authentication will fail.
Install uv if not already installed
The MiniMax MCP server is distributed as a Python package best run with uvx, which handles virtual environment isolation automatically.
curl -LsSf https://astral.sh/uv/install.sh | shAdd the server to Claude Desktop configuration
Open Claude Desktop settings, navigate to Developer > Edit Config, and add the MiniMax server block to claude_desktop_config.json. Set all four environment variables.
{
"mcpServers": {
"MiniMax": {
"command": "uvx",
"args": ["minimax-mcp", "-y"],
"env": {
"MINIMAX_API_KEY": "your-api-key-here",
"MINIMAX_MCP_BASE_PATH": "/Users/yourname/minimax-output",
"MINIMAX_API_HOST": "https://api.minimax.io",
"MINIMAX_API_RESOURCE_MODE": "local"
}
}
}
}Create the output directory
The MINIMAX_MCP_BASE_PATH directory must exist before the server starts. Generated images, audio, and video files are saved here.
mkdir -p /Users/yourname/minimax-outputRestart Claude Desktop and verify connection
Quit and reopen Claude Desktop. The MiniMax server should appear in the connected servers list. Try listing available voices to confirm the connection is working.
Generate your first image
Ask Claude to generate an image using MiniMax. The file will be saved to your configured output directory, and Claude will provide the path or URL depending on your MINIMAX_API_RESOURCE_MODE setting.
MiniMax Examples
Client configuration
Complete claude_desktop_config.json block for the MiniMax MCP server using the Global API endpoint.
{
"mcpServers": {
"MiniMax": {
"command": "uvx",
"args": ["minimax-mcp", "-y"],
"env": {
"MINIMAX_API_KEY": "your-minimax-api-key",
"MINIMAX_MCP_BASE_PATH": "/tmp/minimax",
"MINIMAX_API_HOST": "https://api.minimax.io",
"MINIMAX_API_RESOURCE_MODE": "local"
}
}
}
}Prompts to try
After connecting Claude Desktop to the MiniMax MCP server, try these generation prompts.
- "Generate an image of a futuristic city at sunset with neon lights"
- "Convert this text to speech using a calm female voice: 'Welcome to our product demo'"
- "List all available voices for speech synthesis"
- "Create a short video of ocean waves crashing on a beach"
- "Generate ambient background music with a relaxing, lo-fi feel"
- "Clone a voice from this audio file and synthesize new speech with it"Troubleshooting MiniMax
Authentication fails with 'invalid api key' error
Your API key and MINIMAX_API_HOST must match the same region. Global keys only work with https://api.minimax.io and Mainland China keys only with https://api.minimaxi.com. Double-check both values in your config.
Generated files are not found after a successful call
Verify that MINIMAX_MCP_BASE_PATH points to an existing, writable directory. Create it with `mkdir -p /your/output/path`. If using MINIMAX_API_RESOURCE_MODE=url, files are returned as URLs rather than saved locally.
Server fails to start on Windows
Enable Developer Mode in Claude Desktop settings (the toggle is in the Developer section). This is required on Windows for the uvx subprocess to launch correctly.
Frequently Asked Questions about MiniMax
What is MiniMax?
MiniMax is a Model Context Protocol (MCP) server that bridges 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. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MiniMax?
Follow the installation instructions on the MiniMax GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
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.
NpcPy
★ 1.4kThe python library for research and development in NLP, multimodal LLMs, Agents, ML, Knowledge Graphs, and more.
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.