Release: v0.8.1

What's New

• Google Image Search grounding: When useGoogleSearch is enabled, the model now retrieves both web and image search results before generating images. This provides visual references for real-world subjects (landmarks, products, styles), improving generation accuracy.

Details

• Updated googleSearch tool configuration to include searchTypes: { webSearch, imageSearch }
• Added test coverage for tools parameter structure verification

Note

• Image Search grounding is only supported on gemini-3.1-flash-image-preview (Nano Banana 2). When using quality: "quality" (Nano Banana Pro), only web search grounding is effective.

Release: v0.8.0

Nano Banana 2 Support & Quality Presets

What's New

• Nano Banana 2: Default image generation model is now gemini-3.1-flash-image-preview (Nano Banana 2), delivering faster generation at lower cost
• Three quality presets: Control the speed/fidelity tradeoff via IMAGE_QUALITY environment variable or per-request quality parameter
  • fast (default) — Nano Banana 2, best for drafts and rapid iteration
  • balanced — Nano Banana 2 with enhanced thinking, better detail and coherence
  • quality — Nano Banana Pro (gemini-3-pro-image-preview), highest fidelity for final deliverables
• New aspect ratios: Added 1:4, 1:8, 4:1, 8:1 for ultra-tall and ultra-wide formats
• Updated image sizes: 1K, 2K, 4K options (removed 512px)

Improvements

• LLM-optimized tool descriptions for more accurate parameter usage by AI assistants
• Server-configured quality default is now respected — AI assistants only override when explicitly asked

Release: v0.7.0

Gemini 2.5 Flash Migration

Gemini 2.0 Flash is being deprecated at the end of March 2026. This release migrates the prompt generation model to Gemini 2.5 Flash with tuned parameters to maintain output quality.

What's Changed

• Model: Prompt generation now uses Gemini 2.5 Flash (previously 2.0 Flash)
• SDK: Updated @google/genai from v1.30.0 to v1.42.0
• Output quality: Tuned generation parameters (thinkingBudget, maxTokens, topP, topK) through iterative evaluation to produce concise, high-density prompts
• STYLE directives: Enhanced to encourage specific artistic references and camera specifications in generated prompts
• Docs: Updated README and SKILL.md to reflect the new model
• Security: Bumped ajv from 8.17.1 to 8.18.0 (CVE-2025-69873 ReDoS fix)

Release: v0.6.0

Agent Skill: Image Generation Prompt Best Practices

This release adds a standalone Agent Skill that teaches AI assistants how to write better image generation prompts — no MCP server or API key required.

If your AI tool already has built-in image generation (e.g., Cursor 2.4+), install just the skill:

npx mcp-image skills install --path ~/.cursor/skills

The skill covers the Subject-Context-Style framework, camera/lighting terminology, character consistency, compositional integration, and more. Works with any tool supporting the Agent Skills standard.

Other Changes

• Entry point refactored into thin router (index.ts) + server logic (server-main.ts)
• Added agent-skills and skills keywords to package metadata

Release: v0.5.6

What's Changed

Dependencies

• Bump @modelcontextprotocol/sdk from 1.25.2 to 1.26.0
  • Security fix for cross-client response data leak (GHSA-345p-7cg4-v4c7)
• Bump hono from 4.11.4 to 4.11.7
• Bump lodash from 4.17.21 to 4.17.23

Full Changelog: v0.5.5...v0.5.6

Release: v0.5.5

Security

• Updated hono from 4.11.3 to 4.11.4 to fix JWT algorithm confusion vulnerability
  • See: GHSA-f67f-6cw9-8mq4
  • See: GHSA-3vhc-576x-3qv4

Release: v0.5.4

Security

• Update @modelcontextprotocol/sdk to 1.25.2 to fix ReDoS vulnerability in UriTemplate regex patterns

Release: v0.5.3

Dependencies

Bump qs from 6.14.0 to 6.14.1 (#35)

Updated qs package (indirect dependency via express) to fix minor bugs:

• Ensure arrayLength applies to [] notation as well
• Fix parse to ignore key when custom decoder returns null

CI Improvements

Add production dependency validation (#36)

Added report-missing-dependencies to CI pipeline to automatically detect when devDependencies are incorrectly used in production code. This prevents MODULE_NOT_FOUND errors when installing via npx.

Full Changelog

v0.5.2...v0.5.3

Release v0.5.2

Dependencies

• Bump jws from 4.0.0 to 4.0.1 (security fix for GHSA-869p-cjfg-cm3x)
• Bump @modelcontextprotocol/sdk from 1.22.0 to 1.24.0

Release v0.5.1

What's Changed

Dependencies

• Bump express from 5.1.0 to 5.2.1 (#28)

Full Changelog: v0.5.0...v0.5.1