Image Generation (Flux)
About
Bridges Claude with the Replicate API to generate images using the Flux model directly within conversations through customizable parameters and asynchronous processing.
Details
- Repository
- GongRzhe/Image-Generation-MCP-Server
- License
- MIT
Explore
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Image Generation (Flux)Command (node, npx, python, etc.)npxArguments-
Argument 1
@gongrzhe/image-gen-server
Environment-
MODEL
alternative-model-name -
REPLICATE_API_TOKEN
your-replicate-api-token
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
To install Image Generation MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @GongRzhe/Image-Generation-MCP-Server --client claude
You can use the package directly from npm without installing it locally:
If you prefer a local installation:
npm install -g @gongrzhe/image-gen-server
npm install @gongrzhe/image-gen-server
Edit your Claude Desktop configuration file:
- On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- On Windows: %APPDATA%/Claude/claude_desktop_config.json
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": []
}
}
}
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": []
}
}
}
- REPLICATE_API_TOKEN (required): Your Replicate API token for authentication
- MODEL (optional): The Replicate model to use for image generation. Defaults to "black-forest-labs/flux-schnell"
- 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.
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.
generate_image
Generates images using the Flux model based on text prompts. Parameters: prompt (string, required), seed (optional integer), aspect_ratio (optional string, default: '1:1'), output_format (optional string, default: 'webp', options: 'webp', 'jpg', 'png'), num_outputs (optional integer, range: 1-4, default: 1).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"image generation (flux)": {
"env": {
"MODEL": "alternative-model-name",
"REPLICATE_API_TOKEN": "your-replicate-api-token"
},
"args": [
"@gongrzhe/image-gen-server"
],
"command": "npx"
}
}
}Linux
{
"env": {
"MODEL": "alternative-model-name",
"REPLICATE_API_TOKEN": "your-replicate-api-token"
},
"args": [
"@gongrzhe/image-gen-server"
],
"command": "npx"
}Macos
{
"env": {
"MODEL": "alternative-model-name",
"REPLICATE_API_TOKEN": "your-replicate-api-token"
},
"args": [
"@gongrzhe/image-gen-server"
],
"command": "npx"
}Windows
{
"env": {
"MODEL": "alternative-model-name",
"REPLICATE_API_TOKEN": "your-replicate-api-token"
},
"args": [
"/c",
"npx",
"@gongrzhe/image-gen-server"
],
"command": "cmd"
}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 claude
Option 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 it
Option 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-server
Setup
Configure Claude Desktop
Edit your Claude Desktop configuration file:
- On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- On 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
1. Sign up/login at https://replicate.com
2. Go to https://replicate.com/account/api-tokens
3. Create a new API token
4. Copy the token and replace your-replicate-api-token in the MCP settings
Environment Variables
- REPLICATE_API_TOKEN (required): Your Replicate API token for authentication
- MODEL (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 generate
- seed (optional): Random seed for reproducible generation
- aspect_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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
