NestDaddy

gen-image MCP

io.github.yuluo688/gen-image-mcp ยท v0.2.3

Local stdio MCP for OpenAI-compatible and Gemini image generation, editing, and model fallback.

Connect Runs on your machine

Terminal
claude mcp add gen-image-mcp -e GEN_IMAGE_BASE_URL=<GEN_IMAGE_BASE_URL> -e GEN_IMAGE_API_KEY=<GEN_IMAGE_API_KEY> -e GEN_IMAGE_MODEL=<GEN_IMAGE_MODEL> -e GEN_IMAGE_GEMINI_MODEL=<GEN_IMAGE_GEMINI_MODEL> -e GEN_IMAGE_AUTO_FALLBACK=<GEN_IMAGE_AUTO_FALLBACK> -e GEN_IMAGE_TIMEOUT_MS=<GEN_IMAGE_TIMEOUT_MS> -- npx -y [email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "gen-image-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "GEN_IMAGE_BASE_URL": "<GEN_IMAGE_BASE_URL>",
        "GEN_IMAGE_API_KEY": "<GEN_IMAGE_API_KEY>",
        "GEN_IMAGE_MODEL": "<GEN_IMAGE_MODEL>",
        "GEN_IMAGE_GEMINI_MODEL": "<GEN_IMAGE_GEMINI_MODEL>",
        "GEN_IMAGE_AUTO_FALLBACK": "<GEN_IMAGE_AUTO_FALLBACK>",
        "GEN_IMAGE_TIMEOUT_MS": "<GEN_IMAGE_TIMEOUT_MS>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "gen-image-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "GEN_IMAGE_BASE_URL": "<GEN_IMAGE_BASE_URL>",
        "GEN_IMAGE_API_KEY": "<GEN_IMAGE_API_KEY>",
        "GEN_IMAGE_MODEL": "<GEN_IMAGE_MODEL>",
        "GEN_IMAGE_GEMINI_MODEL": "<GEN_IMAGE_GEMINI_MODEL>",
        "GEN_IMAGE_AUTO_FALLBACK": "<GEN_IMAGE_AUTO_FALLBACK>",
        "GEN_IMAGE_TIMEOUT_MS": "<GEN_IMAGE_TIMEOUT_MS>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "gen-image-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "GEN_IMAGE_BASE_URL": "<GEN_IMAGE_BASE_URL>",
        "GEN_IMAGE_API_KEY": "<GEN_IMAGE_API_KEY>",
        "GEN_IMAGE_MODEL": "<GEN_IMAGE_MODEL>",
        "GEN_IMAGE_GEMINI_MODEL": "<GEN_IMAGE_GEMINI_MODEL>",
        "GEN_IMAGE_AUTO_FALLBACK": "<GEN_IMAGE_AUTO_FALLBACK>",
        "GEN_IMAGE_TIMEOUT_MS": "<GEN_IMAGE_TIMEOUT_MS>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
GEN_IMAGE_BASE_URL
Required
Full HTTP/HTTPS base URL for the configured image API provider.
GEN_IMAGE_API_KEY
Required, secret
API key for the configured image API provider.
GEN_IMAGE_MODEL
Optional
Optional comma-separated OpenAI Images API model list. Configure this or GEN_IMAGE_GEMINI_MODEL.
GEN_IMAGE_GEMINI_MODEL
Optional
Optional comma-separated Gemini image model list. Configure this or GEN_IMAGE_MODEL.
GEN_IMAGE_AUTO_FALLBACK
Optional
Optional true/false switch for sequential model fallback.
GEN_IMAGE_TIMEOUT_MS
Optional
Optional per-request upstream timeout in milliseconds; defaults to 120000. Positive integer, maximum 2147483647.

Details

Package[email protected] (NPM, stdio)
First published10 Oct 2026
Last updated10 Oct 2026
Registry nameio.github.yuluo688/gen-image-mcp

More ai and media servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.