Flux ImageGen MCP Server

Flux ImageGen MCP Server

By falahgs GitHub

-

Overview

What is Flux ImageGen MCP Server?

Flux ImageGen MCP Server is a specialized server for image generation and manipulation, utilizing the Model Context Protocol (MCP) powered by Pollinations AI.

How to use Flux ImageGen MCP Server?

To use the server, clone the repository, install dependencies, and configure it according to your needs. Start the server using Node.js and utilize the available tools for image generation.

Key features of Flux ImageGen MCP Server?

  • 🖼️ Image Generation: Create images from text prompts.
  • 🎨 Multiple Models: Support for various image generation models.
  • 🔧 Flexible Configuration: Easy setup and customization.
  • 🚀 High Performance: Optimized for quick responses.
  • 🔄 MCP Compatible: Fully compliant with Model Context Protocol.

Use cases of Flux ImageGen MCP Server?

  1. Generating images for creative projects.
  2. Automating image creation for web applications.
  3. Experimenting with different image generation models.

FAQ from Flux ImageGen MCP Server?

  • Can I use this server for any type of image generation?

Yes! The server supports various models and can generate images based on diverse prompts.

  • Is there a cost associated with using the server?

No, the server is open-source and free to use.

  • What are the system requirements?

Node.js >= 16.0.0 and NPM >= 7.0.0 are required, and it is compatible with Windows, Linux, and MacOS.

Content

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:

  1. Image URL Generation
  2. Direct Image Generation
  3. 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:

  1. Fork the repository
  2. Create your feature branch
  3. Make your changes
  4. 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

No tools information available.
No content found.