Skip to content

Releases: alexlivre/minimax-image-mcp

Release list

v1.0.1 — README with credits to MiniMax M3

v1.0.1 — README with credits to MiniMax M3 Latest
Latest

Choose a tag to compare

View all tags
@alexlivre alexlivre released this 27 Jun 13:45
v1.0.1
a2d4b45

v1.0.1 — README with credits to MiniMax M3

Docs-only release. The source code, tests, and configuration are unchanged from v1.0.0.

What changed

The README was updated to add a "Built with" section that:

  • Credits MiniMax M3 (the AI model from MiniMax) for writing the entire codebase
  • Explains the vibe coding methodology used throughout the project
  • Distinguishes between the two MiniMax products involved:
    • MiniMax M3 (the AI model that wrote the code)
    • MiniMax image-01 (the upstream API that the MCP server wraps)
  • Points other developers to the patterns (Zod-validated tools, stdio transport, outputSchema) that compose cleanly with any domain API

Why a patch release

Per Semantic Versioning:

Patch versions are reserved for backwards-compatible bug fixes. Documentation changes, even substantial ones, are conventionally bumped as a patch (1.0.0 → 1.0.1) when they don't affect runtime behavior. The dist/ artifact is byte-identical; only README.md changed.

The dist/ produced by npm run build is unchanged from v1.0.0 — the source code was not touched. The npm tarball differs only in the README.md content, which is what the package page renders.

Verify

npm view minimax-image-mcp version
# 1.0.1

npm view minimax-image-mcp readme
# (renders the updated README, including the "Built with" section)

Or open https://www.npmjs.com/package/minimax-image-mcp in a browser.

Full Changelog

See the diff from v1.0.0 → v1.0.1 at:
v1.0.0...v1.0.1

Assets 2
Loading

v1.0.0 — First Public Release

v1.0.0 — First Public Release

Choose a tag to compare

View all tags
@alexlivre alexlivre released this 27 Jun 13:09
v1.0.0
112edf7

v1.0.0 — First Public Release

The first public release of minimax-image-mcp, an MCP server for the MiniMax image-01 image generation API.

Highlights

  • Text-to-image generation with 8 aspect ratios (1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9)
  • Batch generation (1-9 images per call, ~8x faster than separate calls at the same cost)
  • Image-to-image with character reference URLs
  • Prompt optimization flag
  • Seed-based reproducibility (uint32 range)
  • base64 response format (recommended; URLs expire in 24h)
  • Full Jitter retry (AWS algorithm) for transient API errors
  • Strict path-traversal guard on output_dir
  • Graceful shutdown on SIGINT/SIGTERM
  • Progress notifications (notifications/progress) when client provides progressToken
  • Declared outputSchema so MCP clients can validate responses
  • 90% line coverage, 72 unit tests across 4 test files

Quality

  • TypeScript 5.7 with strict: true and noUncheckedIndexedAccess: true
  • Zod validation for inputs, API responses, and tool outputs
  • ESLint 9 with typescript-eslint flat config
  • Cross-platform CI: 6 jobs (Ubuntu, Windows, macOS) × (Node 20, Node 22)
  • Codecov integration with project: 70% and patch: 80% thresholds

Installation

npm install -g minimax-image-mcp

Then configure your MCP client (Claude Desktop, opencode, Cursor, etc.) to spawn node $(npm root -g)/minimax-image-mcp/dist/index.js with MINIMAX_API_KEY in the environment.

See README for full configuration.

Security

No API keys are committed to this repository. The .gitignore covers apikey.txt and .env. See SECURITY.md for responsible disclosure.

Acknowledgments

Full Changelog: https://github.com/alexlivre/minimax-image-mcp/commits/v1.0.0

Loading