Flux Schnell

MCP server that generates images via Replicate using the Flux Schnell model with configurable prompts and robust error handling.

typescript

3

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ckz-flux-schnell-mcp": {
      "command": "node",
      "args": [
        "/path/to/flux-schnell-mcp/build/index.js"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Flux Schnell MCP Server enables you to generate images by calling a Flux Schnell model through the Replicate API via the MCP (Model Context Protocol). This server provides a dedicated tool to create images from text prompts and handles all communication with Replicate, along with robust error handling and structured responses for easy integration with MCP clients.

How to use

You use the Flux Schnell MCP Server by calling its generate_image tool through your MCP client. Provide a detailed text prompt describing the image you want, including style, scene, and details. The server will return the full Replicate response, including the generated image URL and related metadata.

How to install

Prerequisites: you need Node.js version 14 or higher and a Replicate API Token. Ensure your environment is MCP compatible.

Step 1: Clone the project repository and install dependencies.

git clone [repository-url]
cd flux-schnell-mcp
npm install

Step 2: Build the server.

npm run build

Additional configuration and usage notes

The MCP server runs as a local stdio process and can be integrated with compatible MCP clients such as Claude Desktop or VSCode Roo. You need to provide the Replicate API token to authorize requests.

Configuration and security

Configure the MCP server in environments where your MCP client expects a local stdio server. The examples below show how to point your client to the local build of the Flux Schnell MCP server and supply your Replicate API Token.

{
  "mcpServers": {
    "flux_schnell": {
      "command": "node",
      "args": ["/path/to/flux-schnell-mcp/build/index.js"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

In addition, you can configure the same server for a different MCP client path if needed, using the same environment variable for the API token.

Troubleshooting and tips

Keep your Replicate API Token secure and do not share it. Ensure the file path in the server configuration is correct. Image generation can take some time; wait for the response. If you encounter errors, verify that the API token is valid and that network connectivity is available.

For debugging, you can run the server in inspector mode if your MCP tooling supports it to view a debugging URL.

Tools available

generate_image: Generates an image from a text prompt using the Flux Schnell MCP Server and Replicate integration.

Available tools

generate_image

Generates an image based on a textual prompt using the Flux Schnell model via MCP. You provide a detailed prompt to control style, scene, and details of the output.