Image Gen
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:
| Artifact | Surface | What it gives you |
|---|---|---|
image-gen-<os>-<arch>.mcpb | Claude Desktop (Install Extension) | MCP tools (generate_image, check_image_job) |
image-gen-plugin.zip | Claude Desktop or Claude Code | image-gen skill + /image-gpt + /image-gemini slash commands |
mcp/dist/index.js | Manual claude mcp add / claude_desktop_config.json | Same 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 agoUpdated At
8 days agoAuthor Name
Cleveland-RDStar
-Language
-License
-Recommend Servers
View AllAmap Maps
@amap
高德地图官方 MCP Server
a year ago
Serper MCP Server
@garymengcom
A Serper MCP Server
Python
a year ago
Tavily Mcp
@tavily-ai
JavaScript
a year ago