Flux Image MCP Server

by ckz
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Enables image generation using the Flux Schnell model hosted on Replicate, allowing users to create images based on text prompts.

Flux Image MCP Server

This MCP server provides image generation capabilities using the Flux Schnell model on Replicate.

Installation

  1. Install the MCP SDK globally:
npm install -g @modelcontextprotocol/sdk@latest
  1. Clone this repository to your MCP servers directory:
cd ~/Documents/Cline/MCP git clone https://github.com/yourusername/flux-img-mcp.git cd flux-img-mcp npm install
  1. Build the server:
npm run build
  1. Add the server configuration to your MCP settings file (either global or workspace):
{ "mcpServers": { "flux-img": { "command": "node", "args": ["/path/to/flux-img-mcp/build/index.js"], "env": { "REPLICATE_API_TOKEN": "your-replicate-api-token" }, "disabled": false, "alwaysAllow": [] } } }

Configuration

The server requires the following environment variable:

Usage

Once installed and configured, the server provides the following tool:

generate_image

Generates an image using the Flux Schnell model based on a text prompt.

Parameters:

  • prompt (string, required): Text description of the desired image

Example usage:

<use_mcp_tool> <server_name>flux-img</server_name> <tool_name>generate_image</tool_name> <arguments> { "prompt": "A beautiful sunset over mountains" } </arguments> </use_mcp_tool>

The tool will return a JSON response containing:

  • status: The status of the generation request
  • output: The URL of the generated image (if successful)
  • error: Any error message (if failed)

Development

To make changes to the server:

  1. Modify the source code in src/index.ts
  2. Rebuild the server: npm run build
  3. Restart the MCP server for changes to take effect

Error Handling

The server includes comprehensive error handling for:

  • Missing API token
  • Invalid parameters
  • API request failures
  • Network issues

Security

  • Never commit your Replicate API token to version control
  • Always provide the token through environment variables
  • The server validates all input parameters before making API requests
-
security - not tested
A
license - permissive license
-
quality - not tested

Provides image generation capabilities using the Flux Schnell model on Replicate, allowing users to create images from text prompts.

  1. Installation
    1. Configuration
      1. Usage
        1. generate_image
        2. Development
          1. Error Handling
            1. Security