GENERATIVE AI · MINIMAX IMAGE-01

minimax-image-mcp

Integrates the cutting-edge MiniMax image-01 text-to-image API directly into agentic coding workflows.

Model

MiniMax image-01

Runtime

TypeScript / Node

Aspect Ratios

1:1, 16:9, 9:16, 4:3

Distribution

npm package

Executive TL;DR — Engineering Brief

minimax-image-mcp is an official open source MCP tool created by Alex Santos. It connects autonomous agents to MiniMax's high-fidelity image-01 generative engine, supporting prompt styling, aspect ratios, and seed reproduction.

DIAGRAM & WORKFLOW

API Gateway & Async Polling Pipeline

Handles async task polling, URL resolution, and local asset storage seamlessly.

DETAILED ENGINEERING

Core Technical Pillars

Design choices, architectural patterns, and engineering decisions implemented for extreme reliability and developer experience.

Full Parameter Surface of MiniMax image-01

Prompt engineering, negative prompts, aspect ratios, and seeds

Exposes all underlying generation controls to the LLM with native TypeScript typing and parameter boundary checking.

Resilient Polling & Async Task Resolution

Backoff polling with timeout safeguards for high-concurrency workloads

Manages asynchronous generation jobs by polling MiniMax task endpoints with exponential backoff and transparent error reporting.

Automatic Disk Download & Markdown Previews

Saves generated assets directly into local directories with visual summaries

Streams generated web images down to local disk and returns markdown image links for immediate display inside chat interfaces.

Published on npm Registry

Instant execution via npx minimax-image-mcp without manual repository cloning

Distributed as a standalone package on the npm registry, allowing one-line configuration in any MCP-compatible client.

CODE IN ACTION

npm Setup in claude_desktop_config.json

Real-world usage, terminal configuration, and technical integration commands.

Terminal Example SHELL

{
  "mcpServers": {
    "minimax-image": {
      "command": "npx",
      "args": ["-y", "minimax-image-mcp"],
      "env": {
        "MINIMAX_API_KEY": "YOUR_API_KEY",
        "MINIMAX_GROUP_ID": "YOUR_GROUP_ID"
      }
    }
  }
}

QUESTIONS & ANSWERS

Technical Frequently Asked Questions

Key clarifications regarding licensing, compatibility, deployment, and security.

Where do I get a MiniMax API key?

On the official MiniMax platform (minimaxi.com or minimax.io).

What aspect ratios are supported?

1:1 square, 16:9 widescreen, 9:16 portrait, 4:3 classic, and 3:4 portrait.

Can I reproduce exact generations?

Yes, by passing an explicit integer seed value to the generation prompt.

Does it support image-to-image editing?

Currently focused on pure text-to-image generation and prompt-guided iterations.