MiniMax Tools
An MCP server implementation that integrates with Minimax API to provide AI-powered image generation and text-to-speech functionality in editors like Windsurf and Cursor.
What is MiniMax Tools?
MiniMax Tools is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server implementation that integrates with minimax api to provide ai-powered image generation and text-to-speech functionality in editors like windsurf and cursor.
An MCP server implementation that integrates with Minimax API to provide AI-powered image generation and text-to-speech functionality in editors like Windsurf and Cursor.
This server falls under the Data Science & ML category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- An MCP server implementation that integrates with Minimax AP
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx minimax-mcp-toolsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MiniMax Tools
Minimax MCP Tools is an MCP server that integrates the Minimax AI API into editors and AI assistants, exposing asynchronous image generation and text-to-speech capabilities as callable tools. It uses a submit-and-barrier pattern: tasks are submitted in parallel and a task_barrier tool waits for all of them to complete, making it efficient for batch workflows. Developers and content creators use it inside Windsurf, Cursor, or Claude Desktop to generate images from text prompts and produce audio narration without leaving their coding or writing environment.
Prerequisites
- Node.js installed (LTS or current) so npx is available
- A Minimax API key from the Minimax developer platform (platform.minimaxi.com)
- An MCP-compatible client such as Claude Desktop, Cursor, or Windsurf
Obtain a Minimax API key
Sign up or log in at platform.minimaxi.com, navigate to API Keys, and create a new key. Copy the key — you will need it in your MCP client configuration.
Test the server locally
Run the server once with npx to confirm it starts correctly and that your API key is valid. You should see the server initialize without errors.
MINIMAX_API_KEY=your_api_key_here npx minimax-mcp-toolsConfigure your MCP client
Add minimax-mcp-tools to your client configuration with the MINIMAX_API_KEY environment variable set. The server runs via npx and requires no global installation.
Generate an image
Ask your AI assistant to call submit_image_generation with a text prompt, desired aspect ratio, and output file path. Then call task_barrier to wait for the result.
Generate speech from text
Use submit_speech_generation with your text, a voice ID, and speed/emotion settings, then call task_barrier to retrieve the audio file once processing is complete.
MiniMax Tools Examples
Client configuration
Add this to your claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor). Replace the placeholder with your real Minimax API key.
{
"mcpServers": {
"minimax-mcp-tools": {
"command": "npx",
"args": ["minimax-mcp-tools"],
"env": {
"MINIMAX_API_KEY": "your_minimax_api_key_here"
}
}
}
}Prompts to try
Example prompts that use the three Minimax MCP tools: submit_image_generation, submit_speech_generation, and task_barrier.
- "Generate an image of a futuristic city at sunset in 16:9 aspect ratio and save it to /tmp/city.png"
- "Create speech from the text 'Welcome to our product demo' using a professional female voice and save to /tmp/intro.mp3"
- "Submit five image generation tasks in parallel for these five product descriptions, then wait for all of them to finish"
- "Convert the following blog post introduction to audio with a conversational tone: [text]"Troubleshooting MiniMax Tools
401 Unauthorized error when calling image or speech tools
Verify that MINIMAX_API_KEY is set correctly in your MCP client's env block. The key must be a valid active key from platform.minimaxi.com — expired or incorrectly copied keys will return 401.
task_barrier times out before tasks complete
Minimax enforces rate limits: 10 requests per minute for image generation and 20 RPM for speech. If you submit many tasks at once, task_barrier may need to wait through the rate-limit window. Try submitting fewer tasks per batch.
npx minimax-mcp-tools fails with 'package not found'
Run 'npm cache clean --force' and retry. If the issue persists, install the package explicitly with 'npm install -g minimax-mcp-tools' and use 'minimax-mcp-tools' as the command instead of npx.
Frequently Asked Questions about MiniMax Tools
What is MiniMax Tools?
MiniMax Tools is a Model Context Protocol (MCP) server that mcp server implementation that integrates with minimax api to provide ai-powered image generation and text-to-speech functionality in editors like windsurf and cursor. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MiniMax Tools?
Follow the installation instructions on the MiniMax Tools GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MiniMax Tools?
MiniMax Tools works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MiniMax Tools free to use?
Yes, MiniMax Tools is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
MiniMax Tools Alternatives — Similar Data Science & ML Servers
Looking for alternatives to MiniMax Tools? 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 Tools 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 Tools?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.