Skip to content
MCP server

Image Gen

Generate and edit images from your coding agent with Gemini and OpenAI, using your own…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.2.1
Listing updated
4 days ago

About Image Gen

Image Gen is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

Generate and edit images from your coding agent with Gemini and OpenAI, using your own API keys.

Install

Run in a terminal

claude mcp add image-gen --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' -- npx -y @nuver-labs/image-gen-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "image-gen": {
      "command": "npx",
      "args": [
        "-y",
        "@nuver-labs/image-gen-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "image-gen": {
      "command": "npx",
      "args": [
        "-y",
        "@nuver-labs/image-gen-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "image-gen": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@nuver-labs/image-gen-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "image-gen": {
      "command": "npx",
      "args": [
        "-y",
        "@nuver-labs/image-gen-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "image-gen": {
      "command": "npx",
      "args": [
        "-y",
        "@nuver-labs/image-gen-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Configuration

  • GEMINI_API_KEYGoogle Gemini API key. Enables the Gemini provider. At least one provider key is required.
  • OPENAI_API_KEYOpenAI API key. Enables the OpenAI provider. At least one provider key is required.
  • IMAGE_GEN_MCP_DEFAULT_PROVIDERProvider used when a tool call does not name one: gemini or openai. Defaults to whichever key is set, preferring gemini.
  • IMAGE_GEN_MCP_GEMINI_MODELDefault Gemini model. Defaults to gemini-3.1-flash-image.
  • IMAGE_GEN_MCP_OPENAI_MODELDefault OpenAI model. Defaults to gpt-image-2.
  • IMAGE_GEN_MCP_OUTPUT_DIRDirectory used when a tool call passes no output_path.
  • IMAGE_GEN_MCP_ALLOWED_DIRSComma separated directories that file reads and writes are confined to. Unset means unrestricted.
  • IMAGE_GEN_MCP_TIMEOUT_MSPer-request timeout to the provider API in milliseconds. Defaults to 180000.
  • IMAGE_GEN_MCP_LOG_FILEPath of the JSONL image ledger. Defaults to ~/.image-gen-mcp/images.jsonl. Set to none to disable the file.

Pricing

Open source

Image Gen FAQ

Is Image Gen free?

Yes. Image Gen is open source, so you can use and self-host it for free.

How do I add Image Gen to Claude Code?

Run this command in your terminal: claude mcp add image-gen --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' -- npx -y @nuver-labs/image-gen-mcp

What are the best alternatives to Image Gen?

The closest alternatives to Image Gen are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

Alternatives to Image Gen

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media