generate-imageLABSCO SUMMARY
Generation and the folder it ends up in, joined up.
Most image tools hand back a URL that expires while you are still deciding. Here generating, saving under an ID and listing what you kept are three calls in one place, so the good one is still there tomorrow.
What it is
An image generator backed by Replicate's Stable Diffusion, with local storage attached: generate from a prompt, save to disk, and browse what you saved.
What you get
- Image generation from a prompt, with optional negative prompt, width, height, inference steps and guidance scale
- The generated image and its URL returned together
- A generated image saved to a local generated_images directory under a unique ID
- A listing of everything saved, with metadata and thumbnails
- Saved images addressable individually through an image:// URI
- A prompt template that writes the generation prompt for you, with realistic, artistic or abstract styling
Requirements
Python with a virtualenv and the project's requirements, plus a Replicate account. Your Replicate API token goes in a .env file, which the repository already keeps out of version control.
Setup effort
Build from source — git clone https://github.com/rmcendarfer2017/MCP-image-gen.git
USE CASES
01
Trying an idea before committing to it
Generate and look, with nothing written to disk yet.
02
Keeping the one that worked
Save it under a generated ID so the URL expiring stops mattering.
03
Steering away from what you do not want
Put the unwanted elements in the negative prompt and raise the inference steps.
04
Finding something you made last week
List the saved images with their prompts and thumbnails instead of opening a folder.
3 tools
Listed in project docs. Your client may show a different list.
save-imagelist-saved-imagesBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation.
Requires
- uv on PATH
- Python 3.12+
- REPLICATE_API_TOKEN in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/rmcendarfer2017/MCP-image-gen.git
cd MCP-image-gen
cp .env.example .envMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"image-generator": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_MCP_IMAGE_GEN>",
"run",
"image-generator"
]
}
}
}<YOUR_PATH_TO_MCP_IMAGE_GEN> is the full path of your clone. uv run installs the dependencies, and the server reads REPLICATE_API_TOKEN from the .env file in that folder (token from https://replicate.com/account).
