Image Generation MCP Server
Uses the Replicate API and Flux model to generate images based on text prompts with customizable parameters including aspect ratio, output format, and random seed.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Image Generation MCP Server generate an image of a cat wearing sunglasses on a sunny beach"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Image Generation MCP Server
This MCP server provides image generation capabilities using the Replicate Flux model.
Installation
Installing via Smithery
To install Image Generation MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @GongRzhe/Image-Generation-MCP-Server --client claudeOption 1: NPX Method (No Local Setup Required)
You can use the package directly from npm without installing it locally:
# No installation needed - npx will handle itOption 2: Local Installation
If you prefer a local installation:
# Global installation
npm install -g @gongrzhe/image-gen-server
# Or local installation
npm install @gongrzhe/image-gen-serverRelated MCP server: FLUX MCP Server
Setup
Configure Claude Desktop
Edit your Claude Desktop configuration file:
On MacOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonOn Windows:
%APPDATA%/Claude/claude_desktop_config.json
Option 1: NPX Configuration (Recommended)
This method runs the server directly from npm without needing local files:
{
"mcpServers": {
"image-gen": {
"command": "npx",
"args": ["@gongrzhe/image-gen-server"],
"env": {
"REPLICATE_API_TOKEN": "your-replicate-api-token",
"MODEL": "alternative-model-name"
},
"disabled": false,
"autoApprove": []
}
}
}Option 2: Local Installation Configuration
If you installed the package locally:
{
"mcpServers": {
"image-gen": {
"command": "node",
"args": ["/path/to/image-gen-server/build/index.js"],
"env": {
"REPLICATE_API_TOKEN": "your-replicate-api-token",
"MODEL": "alternative-model-name"
},
"disabled": false,
"autoApprove": []
}
}
}Get Your Replicate API Token
Sign up/login at https://replicate.com
Create a new API token
Copy the token and replace
your-replicate-api-tokenin the MCP settings
Environment Variables
REPLICATE_API_TOKEN(required): Your Replicate API token for authenticationMODEL(optional): The Replicate model to use for image generation. Defaults to "black-forest-labs/flux-schnell"
Configuration Parameters
disabled: Controls whether the server is enabled (false) or disabled (true)autoApprove: Array of tool names that can be executed without user confirmation. Empty array means all tool calls require confirmation.
Available Tools
generate_image
Generates images using the Flux model based on text prompts.
Parameters
prompt(required): Text description of the image to generateseed(optional): Random seed for reproducible generationaspect_ratio(optional): Image aspect ratio (default: "1:1")output_format(optional): Output format - "webp", "jpg", or "png" (default: "webp")num_outputs(optional): Number of images to generate (1-4, default: 1)
Example Usage
const result = await use_mcp_tool({
server_name: "image-gen",
tool_name: "generate_image",
arguments: {
prompt: "A beautiful sunset over mountains",
aspect_ratio: "16:9",
output_format: "png",
num_outputs: 1
}
});The tool returns an array of URLs to the generated images.
📜 License
This project is licensed under the MIT License.
Available Tools
1 toolgenerate_imageC
Generate an image using the Flux model
Inputs: prompt (required), seed, aspect_ratio, output_format, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The single tool has a clear and distinct purpose of generating images using the Flux model.
Since there is only one tool, naming consistency is inherently perfect. The tool name 'generate_image' follows a clear verb_noun pattern, and there are no other tools to cause inconsistency.
A single tool for an image generation server is too few for the apparent scope, as it lacks basic operations like listing models, managing generations, or handling variations. This minimal set will likely cause agent failures due to incomplete functionality.
The tool surface is severely incomplete for an image generation domain. It only provides generation without any supporting operations such as model selection, parameter tuning, history retrieval, or image editing, leading to dead ends in agent workflows.
Maintenance
Related MCP Connectors
Generate images and video from Claude with one API key.
Generate and edit images and create short videos inside Claude. Prepaid credits, no subscription.
Generate images, videos, music & lip sync with 200+ AI models (Flux, Veo 3, Kling, Suno)
AI image and video generation, talking avatars, consistent characters and photo packs from Claude.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides image generation capabilities using the Flux Schnell model on Replicate, allowing users to create images from text prompts.2MIT
- AlicenseBqualityDmaintenanceExposes Replicate's FLUX image generation models to Claude, enabling text-to-image generation, image variations, inpainting, and edge-guided creation with 6 different FLUX models.21MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables high-quality image generation with advanced text rendering and contextual understanding using FLUX.1 Kontext Max through the Replicate API. Supports text-to-image generation, image editing, multiple aspect ratios, and automatically downloads generated images locally.1-
- FlicenseNot gradedqualityDmaintenanceImage generation for Claude using every model on fal.ai, inline in conversations. Supports FLUX Schnell, Ideogram, SDXL, and more with privacy option via Venice.ai.-