yuluo688/gen-image-mcp

Overview

Local Model Context Protocol server for image generation and editing. Supports OpenAI-compatible and Gemini APIs with automatic model fallback. Written in TypeScript.

Best for

Best for
Developers building MCP-based tools that need local image generation with provider fallback.

Use cases

• Generate images from text prompts through MCP-compatible clients
• Edit existing images using Gemini or OpenAI-compatible models
• Add automatic fallback between image model providers

How to use

Install

npx -y gen-image-mcp --base-url "https://your-proxy.example" --model "images-model-a,images-model-b" --auto-fallback true

Tools exposed

• GEN_IMAGE_BASE_URL
• GEN_IMAGE_API_KEY
• GEN_IMAGE_MODEL
• GEN_IMAGE_GEMINI_MODEL
• GEN_IMAGE_AUTO_FALLBACK
• GEN_IMAGE_TIMEOUT_MS
• list_models
• generate_image
• edit_image
• generate_gemini_image
• elapsed_ms
• attempt_count
• retry_count
• model_switches

Tested with

ChatGPT

Notes

Local Model Context Protocol server for image generation and editing. Supports OpenAI-compatible and Gemini APIs with automatic model fallback. Written in TypeScript.

0 stars on GitHub. Last updated 2026-09-21. Licensed MIT.

Use cases

• Generate images from text prompts through MCP-compatible clients
• Edit existing images using Gemini or OpenAI-compatible models
• Add automatic fallback between image model providers

Pros

• Runs locally, keeping API keys and data on the user’s machine
• Supports both OpenAI-compatible and Gemini endpoints
• Automatic fallback reduces failed image requests

Cons

• No community adoption yet, zero stars on GitHub
• Requires manual setup and configuration of API endpoints
• Limited to OpenAI-compatible and Gemini providers

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.