@ckz_2055/minimax-image-mcp

MCP (Model Context Protocol) server for MiniMax Image Generation API. Generate high-quality AI images directly from Claude Desktop, Cursor, or any MCP-compatible client.

Features

• 🎨 Text-to-Image Generation - Create images from text descriptions
• 📐 Multiple Aspect Ratios - Support for 1:1, 16:9, 4:3, 9:16, and more
• 🔢 Batch Generation - Generate up to 9 images at once
• 🔗 Flexible Output - Get image URLs or base64 data

Installation

npm install -g @ckz_2055/minimax-image-mcp

Or use with npx:

npx @ckz_2055/minimax-image-mcp

Configuration

Get Your API Key

1. Visit MiniMax Platform
2. Create an account and generate an API key
3. Copy your API key for configuration below

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "minimax-image": {
      "command": "npx",
      "args": ["-y", "@ckz_2055/minimax-image-mcp"],
      "env": {
        "MINIMAX_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP configuration (~/.cursor/mcp.json):

{
  "mcpServers": {
    "minimax-image": {
      "command": "npx",
      "args": ["-y", "@ckz_2055/minimax-image-mcp"],
      "env": {
        "MINIMAX_API_KEY": "your-api-key-here"
      }
    }
  }
}

Other MCP Clients

For other MCP-compatible clients, configure the server with:

• Command: npx
• Arguments: ["-y", "@ckz_2055/minimax-image-mcp"]
• Environment: MINIMAX_API_KEY=your-api-key-here

Usage

Once configured, you can ask your AI assistant to generate images:

"Generate an image of a sunset over mountains"

"Create a 16:9 landscape of a futuristic city at night"

"Generate 3 variations of a cat wearing a space suit"

Tool Reference

generate_image

Generate images using MiniMax AI.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | prompt | string | ✓ | - | Image description (max 1500 chars) | | aspect_ratio | string | | 1:1 | 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9 | | model | string | | image-01 | Model to use | | n | number | | 1 | Number of images (1-9) | | response_format | string | | url | url or base64 |

Requirements

• Node.js 18 or higher
• MiniMax API key

Troubleshooting

"MINIMAX_API_KEY environment variable is not set"

Make sure you've added the env configuration with your API key to your MCP client settings.

API Errors

• 1002: Rate limit exceeded - wait and try again
• 1004: Authentication failed - check your API key
• 1026: Content policy violation - modify your prompt

License

MIT

Links

• MiniMax Platform
• MiniMax API Documentation
• Model Context Protocol