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
- Author
- gongrzhe
- Repository
- GongRzhe/Image-Generation-MCP-Server
- GitHub stars
- 40
- License
- MIT License
- Categories
- Productivity, Developer Tools, Design, AI, Media, API, Infrastructure, Frontend
- Tags
- #mobile
Jump to
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"
}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 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.
