Flux Imagegen MCP Server

🚀 Fluid Image Generation MCP Server

Fluid Image Generation MCP Server is an optimized server implementation that offers powerful image generation capabilities through the Model Context Protocol (MCP). It is supported by Pollinations AI.

Developers

• Author: Falah.G.Salieh
• Copyright: © 2025, All rights reserved

Overview

The Fluid Image Generation MCP Server is an optimized server implementation that provides powerful image generation capabilities through the Model Context Protocol (MCP). This server focuses on the following three core functions:

1. Image URL Generation
2. Direct Image Generation
3. Model Listing and Management

✨ Features

• 🖼️ Image Generation: Create stunning images based on text prompts.
• 🎨 Multiple Model Support: Compatible with various image generation models.
• 🔧 Flexible Configuration: Easy to install and customize.
• 🚀 High Performance: Optimized for fast response times.
• 🔄 MCP Compatibility: Fully compliant with the Model Context Protocol.

📦 Installation

# Clone the repository
git clone https://github.com/yourusername/flux-imagegen-mcp-server.git

# Install dependencies
npm install

Configuration

Configuration for Claude Desktop

To use this server in Claude Desktop, update your configuration file located 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 the actual path to your server.

💻 Usage Examples

Available Tools

1. Generate Image URL (generateImageUrl)

Generate a URL for an image based on a text prompt.

{
  "prompt": "A magnificent sunset view",
  "model": "flux",  // Optional, default is 'flux'
  "width": 1024,    // Optional
  "height": 1024,   // Optional
  "enhance": true,  // Optional
  "safe": false     // Optional
}

2. Direct Image Generation (generateImage)

Generate and save an image directly based on a text prompt.

{
  "prompt": "A serene lake reflecting the mountains",
  "model": "flux",
  "width": 1024,
  "height": 1024,
  "enhance": true,
  "safe": false,
  "outputPath": "./output",
  "fileName": "mountain_lake",
  "format": "png"
}

3. List Image Models (listImageModels)

Return 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
• Supports Windows/Linux/MacOS

Development

To contribute to or modify the server:

1. Fork the repository.
2. Create a feature branch.
3. Make your changes.
4. Submit your changes.

Error Handling and Logging

• Use try-catch to handle errors.
• Log key operations.

Basic Usage

// Example server startup code:
const express = require('express');
const app = express();

app.get('/generate-image', (req, res) => {
  try {
    // Process the request and generate an image
    res.send(imageData);
  } catch (error) {
    console.error('Error generating image:', error);
    res.status(500).send('Failed to generate image');
  }
});

app.listen(3000, () => {
  console.log('Server started, listening on port 3000');
});

Contributors

• [Your Name]
• [Contributor Name]

📄 License

[Add license information here]

Fluid Image Generation MCP Server
© 2025, All rights reserved