gen-image MCP Server

by yuluo688io.github.yuluo688/gen-image-mcpv0.2.2

Generate and edit images via your own OpenAI-compatible or Gemini image APIs and save them into the project directory, with optional model fallback.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active19d ago

Install gen-image MCP server

claude mcp add gen-image -e GEN_IMAGE_BASE_URL='<gen-image-base-url>' -e GEN_IMAGE_API_KEY='<gen-image-api-key>' -- npx -y gen-image-mcp

{
  "mcpServers": {
    "gen-image": {
      "command": "npx",
      "args": [
        "-y",
        "gen-image-mcp"
      ],
      "env": {
        "GEN_IMAGE_BASE_URL": "<gen-image-base-url>",
        "GEN_IMAGE_API_KEY": "<gen-image-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "gen-image": {
      "command": "npx",
      "args": [
        "-y",
        "gen-image-mcp"
      ],
      "env": {
        "GEN_IMAGE_BASE_URL": "<gen-image-base-url>",
        "GEN_IMAGE_API_KEY": "<gen-image-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "gen-image": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gen-image-mcp"
      ],
      "env": {
        "GEN_IMAGE_BASE_URL": "<gen-image-base-url>",
        "GEN_IMAGE_API_KEY": "<gen-image-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "gen-image": {
      "command": "npx",
      "args": [
        "-y",
        "gen-image-mcp"
      ],
      "env": {
        "GEN_IMAGE_BASE_URL": "<gen-image-base-url>",
        "GEN_IMAGE_API_KEY": "<gen-image-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GEN_IMAGE_BASE_URL	yes	—	Full HTTP/HTTPS base URL for the configured image API provider.
GEN_IMAGE_API_KEY	yes	yes	API key for the configured image API provider.
GEN_IMAGE_MODEL	—	—	Optional comma-separated OpenAI Images API model list. Configure this or GEN_IMAGE_GEMINI_MODEL.
GEN_IMAGE_GEMINI_MODEL	—	—	Optional comma-separated Gemini image model list. Configure this or GEN_IMAGE_MODEL.
GEN_IMAGE_AUTO_FALLBACK	—	—	Optional true/false switch for sequential model fallback.

Freshness

Active — last maintenance signal 19d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-21 · 19d ago · GitHub
Latest release
2026-09-21 · 19d ago · GitHub · v0.2.2
Package published
no data · npm/PyPI
Registry entry updated
2026-09-21 · 19d ago · official registry · v0.2.2

FAQ

›How do I install the gen-image MCP server in Claude Code?

Run: claude mcp add gen-image -e GEN_IMAGE_BASE_URL='<gen-image-base-url>' -e GEN_IMAGE_API_KEY='<gen-image-api-key>' -- npx -y gen-image-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does gen-image require an API key?

Yes. It expects GEN_IMAGE_BASE_URL, GEN_IMAGE_API_KEY, of which 1 is a secret.

›Can I use gen-image as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is gen-image in the official MCP registry?

Yes, as io.github.yuluo688/gen-image-mcp.