flux-imagegen-mcp-server
If you are the rightful owner of flux-imagegen-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Flux ImageGen MCP Server is a specialized server for image generation and manipulation using the Model Context Protocol, powered by Pollinations AI.
Flux ImageGen MCP Server
A specialized Model Context Protocol (MCP) server for image generation and manipulation, powered by Pollinations AI.
Developer
- Author: Falah.G.Salieh
- Copyright: © 2025 All rights reserved
Overview
ImageGen MCP Server is a streamlined server implementation that provides powerful image generation capabilities through the Model Context Protocol (MCP). This server specializes in three core functionalities:
- Image URL Generation
- Direct Image Generation
- Model Listing and Management
Features
- 🖼️ Image Generation: Create stunning images from text prompts
- 🎨 Multiple Models: Support for various image generation models
- 🔧 Flexible Configuration: Easy to set up and customize
- 🚀 High Performance: Optimized for quick response times
- 🔄 MCP Compatible: Fully compliant with Model Context Protocol
Installation
# Clone the repository
git clone https://github.com/yourusername/flux-imagegen-mcp-server.git
# Install dependencies
npm install
Configuration
Claude Desktop Configuration
To use this server with Claude Desktop, update your configuration file at:
C:\Users\[YourUsername]\AppData\Roaming\Claude\claude_desktop_config.json
{
"mcpServers": {
"mcpollinations": {
"command": "cmd",
"args": [
"/c",
"node",
"PATH_TO_YOUR_SERVER\\server.js"
],
"tools": [
"generateImageUrl",
"generateImage",
"listImageModels"
]
}
}
}
Replace PATH_TO_YOUR_SERVER with your actual server path.
Available Tools
1. Generate Image URL (generateImageUrl)
Generates a URL for an image based on a text prompt.
{
"prompt": "A beautiful sunset over mountains",
"model": "flux", // optional, defaults to 'flux'
"width": 1024, // optional
"height": 1024, // optional
"enhance": true, // optional
"safe": false // optional
}
2. Generate Image (generateImage)
Generates and saves an image directly from a text prompt.
{
"prompt": "A serene lake reflecting mountains",
"model": "flux",
"width": 1024,
"height": 1024,
"enhance": true,
"safe": false,
"outputPath": "./output",
"fileName": "mountain_lake",
"format": "png"
}
3. List Image Models (listImageModels)
Returns a list of available image generation models.
// Example response:
{
"models": [
{
"id": "flux",
"name": "Flux",
"description": "Default image generation model"
},
// ... other models
]
}
Running the Server
# Start the server
node server.js
Environment Requirements
- Node.js >= 16.0.0
- NPM >= 7.0.0
- Windows/Linux/MacOS compatible
Development
To contribute or modify the server:
- Fork the repository
- Create your feature branch
- Make your changes
- Submit a pull request
Error Handling
The server provides detailed error messages for common issues:
{
"error": {
"code": "ERROR_CODE",
"message": "Human-readable error message",
"details": { /* Additional error details */ }
}
}
Examples
Basic Image Generation
// Generate an image URL
const response = await generateImageUrl({
prompt: "A futuristic city at night",
model: "flux",
width: 1024,
height: 1024
});
// Generate and save an image
const image = await generateImage({
prompt: "A peaceful garden with butterflies",
outputPath: "./images",
fileName: "garden_scene"
});
Download Image Example
// Download an image from URL
const downloadResult = await downloadImage({
imageUrl: "https://example.com/image.jpg",
fileName: "downloaded-image",
format: "png"
});
Support
For issues and feature requests, please create an issue in the repository or contact the developer:
- Email: [Your contact email]
- GitHub: [Your GitHub profile]
License
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by Falah.G.Salieh © 2025 All rights reserved
