Image Gen

Created By
Cleveland-RD8 days ago
Local stdio MCP server for generating and editing images via OpenAI gpt-image-2 or Google Gemini (Nano Banana / Pro image-preview). Saves PNGs to ~/Pictures/image-gen/ and returns inline JPEG thumbnails. Bring your own OpenAI and/or Gemini API key.
Overview

Image Gen

Open-source Claude plugin + stdio MCP server for generating and editing images via OpenAI gpt-image-2 and Google Gemini (gemini-3.1-flash-image-preview / gemini-3-pro-image-preview, aka Nano Banana / Pro). Bring your own OpenAI and/or Gemini API key.

Tools

  • generate_image — Generate or edit an image via OpenAI gpt-image-2 or Google Gemini. Accepts a prompt plus optional reference images, model selection, size, and quality settings.
  • check_image_job — Poll a previously-started image generation job.

PNGs land in ~/Pictures/image-gen/; the tool returns an inline JPEG thumbnail so the client can render the result immediately.

Install

Three install surfaces, depending on the client:

ArtifactSurfaceWhat it gives you
image-gen-<os>-<arch>.mcpbClaude Desktop (Install Extension)MCP tools (generate_image, check_image_job)
image-gen-plugin.zipClaude Desktop or Claude Codeimage-gen skill + /image-gpt + /image-gemini slash commands
mcp/dist/index.jsManual claude mcp add / claude_desktop_config.jsonSame MCP, full manual control

Published .mcpb builds: darwin-arm64, darwin-x64, win32-x64. Linux users build from source via the Claude Code install guide.

Claude Code (quick path)

# 1. Download + extract the platform-matching .mcpb
curl -L -o /tmp/image-gen.mcpb \
   https://github.com/Cleveland-RD/claude-image-gen/releases/latest/download/image-gen-darwin-arm64.mcpb
mkdir -p ~/.image-gen-mcp && unzip -oq /tmp/image-gen.mcpb -d ~/.image-gen-mcp

# 2. Register with Claude Code
claude mcp add image-gen -s user \
   -e OPENAI_API_KEY="sk-..." \
   -e GEMINI_API_KEY="..." \
   -- node "$HOME/.image-gen-mcp/server/index.js"

Claude Desktop

Download the .mcpb matching your OS + CPU from Releases and open it — Desktop prompts for API keys on install.

API keys

At least one required:

- OpenAI for gpt-image-2 — platform.openai.com/api-keys
- Gemini for Nano Banana / Pro — aistudio.google.com/apikey

Server Config

{
  "mcpServers": {
    "image-gen": {
      "command": "node",
      "args": [
        "<HOME>/.image-gen-mcp/server/index.js"
      ],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>"
      }
    }
  }
}
Project Info
Created At
8 days ago
Updated At
8 days ago
Author Name
Cleveland-RD
Star
-
Language
-
License
-
Category

Recommend Servers

View All