Image Gen MCP server

image-gen-mcp

Generate and edit images from your coding agent, with your own API keys. Ask for a blog cover, a logo tweak, or a placeholder illustration, and the file lands directly in your project where the agent can read it and iterate.

Google Gemini image models (the Nano Banana family) and OpenAI GPT image models behind one interface. Configure one provider or both.

This banner and the repository's social preview card were both generated by this server, with gemini-3.1-flash-image at 16:9 2K. Prompts are in assets/README.md.

Install

claude mcp add image-gen --scope user \
  --env GEMINI_API_KEY=your-gemini-key \
  --env OPENAI_API_KEY=your-openai-key \
  -- npx -y @nuver-labs/image-gen-mcp

Start a new Claude Code session to pick it up, then check claude mcp list.

Three things that trip people up:

Above, --scope does that job. Put the name straight after an --env pair and the CLI reads it as another KEY=value.

• At least one option must sit between the last --env and the server name.

get parsed as Claude Code's.

• -- before the command is mandatory. Without it the server's own arguments

• Drop the --env line for any provider you do not use. You need at least one.

Get keys from Google AI Studio and the OpenAI platform.

Other clients

Same package everywhere. For .mcp.json (project scope, commit it) and Claude Desktop (~/Library/Application Support/Claude/claudedesktopconfig.json):

{
  "mcpServers": {
    "image-gen": {
      "command": "npx",
      "args": ["-y", "@nuver-labs/image-gen-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-key",
        "OPENAI_API_KEY": "your-openai-key"
      }
    }
  }
}

Claude Code also accepts a per-server "timeout": 600000, which Claude Desktop does not. Cursor uses the same shape in .cursor/mcp.json. On Windows, GUI hosts cannot always find npx, so use "command": "cmd" with "args": ["/c", "npx", "-y", "@nuver-labs/image-gen-mcp"].

Use it

Just ask, in plain language:

• "Generate a 16:9 hero image of a lighthouse at dusk and save it to assets/hero.png"
• "Take public/logo.png and give it a transparent background"
• "Create 3 variations of a flat paper airplane icon, square, into design/drafts/"

The agent calls generateimage or editimage with an absolute outputpath inside your project, the file lands on disk, and the agent can then read the saved path to look at the result and refine it. If a call fails, ask it to run listcapabilities to see what is actually configured.

Tools

generate_image

Shortened. The full README is on GitHub.