Image Gen MCP Server

by nuver-labscom.nuverlabs/image-genv0.2.1

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

1Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained58d ago

Install Image Gen MCP server

claude mcp add image-gen -e GEMINI_API_KEY='<gemini-api-key>' -e OPENAI_API_KEY='<openai-api-key>' -- npx -y @nuver-labs/image-gen-mcp

{
  "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 (global) or .cursor/mcp.json (project).

{
  "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>"
      }
    }
  }
}

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

{
  "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 .vscode/mcp.json in your workspace.

{
  "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 ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GEMINI_API_KEY	—	yes	Google Gemini API key. Enables the Gemini provider. At least one provider key is required.
OPENAI_API_KEY	—	yes	OpenAI API key. Enables the OpenAI provider. At least one provider key is required.
IMAGE_GEN_MCP_DEFAULT_PROVIDER	—	—	Provider used when a tool call does not name one: gemini or openai. Defaults to whichever key is set, preferring gemini.
IMAGE_GEN_MCP_GEMINI_MODEL	—	—	Default Gemini model. Defaults to gemini-3.1-flash-image.
IMAGE_GEN_MCP_OPENAI_MODEL	—	—	Default OpenAI model. Defaults to gpt-image-2.
IMAGE_GEN_MCP_OUTPUT_DIR	—	—	Directory used when a tool call passes no output_path.
IMAGE_GEN_MCP_ALLOWED_DIRS	—	—	Comma separated directories that file reads and writes are confined to. Unset means unrestricted.
IMAGE_GEN_MCP_TIMEOUT_MS	—	—	Per-request timeout to the provider API in milliseconds. Defaults to 180000.
IMAGE_GEN_MCP_LOG_FILE	—	—	Path of the JSONL image ledger. Defaults to ~/.image-gen-mcp/images.jsonl. Set to none to disable the file.

Freshness

Maintained — last maintenance signal 58d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-13 · 58d ago · GitHub
Latest release
2026-08-13 · 58d ago · GitHub · v0.2.1
Package published
no data · npm/PyPI
Registry entry updated
2026-08-13 · 58d ago · official registry · v0.2.1

FAQ

›How do I install the Image Gen MCP server in Claude Code?

Run: claude mcp add image-gen -e GEMINI_API_KEY='<gemini-api-key>' -e OPENAI_API_KEY='<openai-api-key>' -- npx -y @nuver-labs/image-gen-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Image Gen require an API key?

Yes. It expects GEMINI_API_KEY, OPENAI_API_KEY, of which 2 are secrets.

›Can I use Image Gen as a remote (hosted) MCP server?

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

›Is Image Gen in the official MCP registry?

Yes, as com.nuverlabs/image-gen.