MiniMax MCP JS

What is MiniMax MCP JS?

MiniMax MCP JS is a JavaScript/TypeScript implementation of the Model Context Protocol (MCP) server that provides image generation, video generation, text-to-speech, voice cloning, music generation, and voice design via MiniMax’s API. It is designed for developers who want to integrate MiniMax’s generative AI capabilities into MCP‑compatible clients such as Claude Desktop or Cursor.

How to use MiniMax MCP JS?

Install the package with pnpm add minimax-mcp-js (or globally with pnpm install -g minimax-mcp-js), obtain an API key from the MiniMax platform, and configure your MCP client (e.g., Claude Desktop) with the server command npx -y minimax-mcp-js and the required environment variables MINIMAX_API_HOST, MINIMAX_API_KEY, MINIMAX_MCP_BASE_PATH, and optionally MINIMAX_RESOURCE_MODE. The server can also be started programmatically via startMiniMaxMCP() or as a CLI tool with command‑line arguments.

Key features of MiniMax MCP JS

• Text‑to‑Speech (TTS) generation
• Image generation from text prompts
• Video generation (supports MiniMax-Hailuo-02 model)
• Voice cloning and custom voice design
• Music generation (powered by music‑1.5 model)
• Dynamic configuration via environment variables, request parameters, or CLI args
• Compatible with MCP platform hosting (ModelScope and others)

Use cases of MiniMax MCP JS

• Generate audio files from text input using TTS
• Create images and videos from natural language descriptions
• Design unique voices with descriptive prompts for character or brand applications
• Produce high‑quality music tracks for media projects
• Integrate multimodal generation into AI assistants or chat clients

FAQ from MiniMax MCP JS

How do I get an API key for MiniMax MCP JS?

Visit the MiniMax International Platform (for global users) or the MiniMax platform (for mainland China) to obtain your interface key. The API key must match the correct host address for your region.

What transport modes does MiniMax MCP JS support?

It supports three modes: stdio (default, local only), REST (HTTP requests, local or cloud), and SSE (server‑sent events, local or cloud). Input restrictions differ: local files or URLs are accepted in local deployments, while URL input is recommended when deployed in the cloud.

What are the region‑specific API hosts?

For global users the host is https://api.minimaxi.chat (note the extra “i”); for mainland China users it is https://api.minimax.chat. Using the wrong host will result in an “Invalid API key” error.

Can MiniMax MCP JS be used with Cursor?

Yes. Add the server configuration in Cursor’s MCP settings. If you encounter a “No tools found” error, update Cursor to the latest version.

How do I configure MiniMax MCP JS with per‑request settings?

In platform hosting environments, pass an independent meta.auth object in the request parameters containing api_key, api_host, base_path, and resource_mode. This enables multi‑tenant usage with different API keys per request.