⌁ labsco summary — our analysis, not the vendor's

What it is — An MCP server that generates images from text prompts using the Flux Schnell model hosted on Replicate.

What you get —

generate_image — turn a text prompt into an image, e.g. {"prompt": "A beautiful sunset over mountains"}, returning the output image URL
Status/output/error fields in the JSON response
Input validation and comprehensive error handling (missing token, bad params, API/network failures)

Requirements — A Replicate API token (REPLICATE_API_TOKEN) from your Replicate account settings; also the MCP SDK and Node build step.

Cost snapshot — Server is free/MIT, but it fronts Replicate's hosted Flux Schnell — you need a Replicate account and API token, and image generation is billed by Replicate. No prices shown.

Setup effort — Clone, npm install, npm run build, then wire the built index.js into your MCP settings with the token.

Our take — A thin, single-purpose wrapper that's fine if you just want Flux images in an assistant. Real caveat: it does one thing (generate_image) and every call costs Replicate credits, so it's neither free nor feature-rich.

Source: the project README — summarized 2026-07-08.

⌁ readme from github — mirrored (latest on GitHub ↗)

Flux Image MCP Server

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

Development

To make changes to the server:

Modify the source code in src/index.ts
Rebuild the server: npm run build
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

Copy & paste — that's it

{
  "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": []
    }
  }
}

Before it works, you'll need: REPLICATE_API_TOKEN

Installation

Install the MCP SDK globally:

npm install -g @modelcontextprotocol/sdk@latest

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

Build the server:

npm run build

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:

REPLICATE_API_TOKEN: Your Replicate API token. You can get this from your Replicate account settings.

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)

No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.

Licensed under MIT— you can use, modify, and redistribute it under that license's terms.

View the full license file on GitHub →