Replicate Flux

Name: Replicate Flux
Author: newtype-01

@newtype-01

Repository

About Replicate Flux

A MCP server for running Flux AI image generation model on Replicate

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "replicate-flux": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-e",
        "REPLICATE_API_TOKEN=your_token_here",
        "replicate-flux"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Replicate Flux?

Replicate Flux is a TypeScript-based MCP server that runs the Flux AI image generation model (black-forest-labs/flux-dev) on the Replicate platform. It is designed for developers using MCP-compatible applications such as Claude to generate images programmatically.

How to use Replicate Flux?

Clone the repository, install dependencies with npm install, create a .env file with your Replicate API token, then build with npm run build. Run the server directly via node build/index.js, via npx Replicate-Flux, or using Docker. Configure MCP clients (e.g., Claude) by adding a JSON entry to their settings, specifying the command as the server path, npx, or docker.

Key features of Replicate Flux

Generate images using the black-forest-labs/flux-dev model on Replicate.
Simple integration with any MCP-compatible client (Claude, etc.).
Customizable image generation parameters.
Supports local, npx, and Docker execution methods.
Environment variable configuration for the API token.
Auto-rebuild during development with npm run watch.

Use cases of Replicate Flux

Generate AI images from text prompts directly within Claude.
Integrate image generation into automated workflows using MCP.
Test and iterate on image prompts with customizable parameters.
Deploy image generation in containerized environments.

FAQ from Replicate Flux

What runtime does Replicate Flux require?

Node.js 18 or later must be installed.

How do I get a Replicate API token?

Obtain your token from your Replicate account at https://replicate.com/account.

Can I run Replicate Flux in a Docker container?

Yes. Build the Docker image with docker build -t replicate-flux . and run it, passing the API token via the -e flag.

How do I configure Replicate Flux for use with Claude?

Add a JSON entry to your MCP client settings using the local installation path, npx, or Docker command, and include the environment variable if not set system-wide.