Replicate Flux MCP

Community

MCP server for high-quality image and SVG generation for developers

How to install ↓ Compare GitHub source repository ↗

Category: Other
Stars: ★ 105 Popular
Transport: stdio (local process)
Runtime: Node.js
Credentials: API key / credential required
License: MIT
Last commit: 10 days ago
Tools: 9

56FMRS · C

This server is feature-rich, supporting multiple image generation modes, but depends on the Replicate API which requires a paid token. Setup is straightforward and integrates well with major clients, but lacks automated tests.

Strongest · Documentation 14/20 Weakest · Reliability 8/20

Reliability

8/20

Security and permissions

10/20

Maintenance

12/20

Documentation

14/20

Setup experience

12/20

Why each score

Reliability 8/20: Evidence: README and source describe a consistent set of tools and claim MCP protocol 2025-11-25. However, no automated test suite exists; README explicitly states 'no automated test suite' and verification via build and Inspector smoke tests. Thus key path reproducibility is unverified and error handling details are unknown. Deduction: no tests, static review cannot confirm actual behavior.
Security and permissions 10/20: Evidence: API token passed via environment variable, no real secrets in docs or config examples. Tool annotations include readOnlyHint/destructiveHint, disable_safety_checker option defaults to false. run_replicate_model allows any model but can be restricted via REPLICATE_MODEL_ALLOWLIST, though unset by default. Deduction: no confirmation mechanism verified, but no gross overreach or malicious behavior found.
Maintenance 12/20: Evidence: Repository is active with 105 stars, 0 open issues, MIT license. Multiple integration badges and version number present. Deduction: no concrete evidence of commit frequency, recent activity, or security response channel; no automated tests or maintenance process documented.
Documentation 14/20: Evidence: README is extensive, covering installation, integrations, tool parameters, env vars, examples, and troubleshooting. Bilingual. Deduction: missing cost information, rate limits, and more detailed error handling docs.
Setup experience 12/20: Evidence: Provides config examples for multiple clients (Cursor, Claude Desktop, Smithery, Glama, Codex), clear install steps, runs via npx. Deduction: static review cannot verify actual setup success rate; no CI or automated test evidence.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

Best for

Developers needing quick visual assets for their projects
Users who want to generate images directly from Claude Desktop or Cursor
Scenarios requiring structured output (e.g., JSON) for programmatic use

Not for

Fully offline image generation (relies on Replicate API)
Use cases with strict privacy requirements where prompts cannot be sent to external services
Users expecting unlimited free generation (Replicate API is usage-based and paid)

Required permissions

Access to Replicate API (requires REPLICATE_API_TOKEN)
Making network requests to Replicate to generate and retrieve results
Reading and writing local configuration files and environment variables

Risks and side effects

API key leakage could lead to unauthorized usage and charges
Generated images may contain inappropriate content (safety filter exists but can be bypassed)
Dependence on external service: network latency or downtime possible
Running arbitrary models via run_replicate_model may incur unexpected costs and outputs

Setup

Before you start

Runtime：Node.js

REPLICATE_API_TOKEN requiredsecret Replicate API token, required; create one at replicate.com/account/api-tokens. The server exits immediately if missing.

Other optional settings (3)

REPLICATE_IMAGE_MODEL_ID optional Optional; overrides the default image model for generate tools, must be in the built-in image allowlist.

REPLICATE_SVG_MODEL_ID optional Optional; overrides the SVG model used by generate_svg, must be in the built-in SVG allowlist.

REPLICATE_MODEL_ALLOWLIST optional Optional; comma-separated owner/name entries gating run_replicate_model. Unset = any model allowed; set-but-empty = deny all (fail-closed).

Obtain a Replicate API token by signing up at replicate.com.
Choose your integration method: for Claude Desktop, add the configuration to your mcp.json file; for Cursor, create/edit .cursor/mcp.json; for Codex, add to ~/.codex/config.toml.
Replace 'YOUR_TOKEN' with your actual API token.
Restart your MCP client to apply changes.

claude_desktop_config.json

{
  "mcpServers": {
    "replicate-flux-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "replicate-flux-mcp"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "YOUR TOKEN"
      }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json

{
  "servers": {
    "replicate-flux-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "replicate-flux-mcp"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "YOUR TOKEN"
      }
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

claude mcp add replicate-flux-mcp -e 'REPLICATE_API_TOKEN=YOUR TOKEN' -- npx -y replicate-flux-mcp

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After connecting in Claude Desktop or Cursor, the tool list should include generate_image, generate_svg, and other recorded tools; then issue a natural-language image request and confirm it returns an image URL.

Troubleshooting

Authentication error: verify REPLICATE_API_TOKEN is correctly set and valid
Safety filter triggered: modify prompt to avoid problematic content
Timeout error: increase pollingAttempts or pollingInterval in configuration
Model override not working: ensure model ID is in the built-in allowlist

Things to try

Once connected, you can ask your AI assistant things like:

Generate an image of a serene mountain landscape at sunset
Create a modern minimalist logo for my brand as an SVG
Generate 4 variants of a futuristic city skyline at night using different seeds
Show me a list of my recent Replicate predictions

Tools 9

generate_image writes

Generates an image based on a text prompt

generate_multiple_images writes

Generates multiple images from an array of prompts

generate_image_variants writes

Generates multiple variants of an image from a single prompt

generate_svg writes

Generates SVG/vector output based on a text prompt

prediction_list read-only

Retrieves a list of recent predictions from Replicate

get_prediction read-only

Gets detailed information about a specific prediction

run_model writes

Runs a whitelisted Replicate model with a raw input payload

run_replicate_model writes

Runs any model hosted on Replicate by its owner/name reference

Show 1 more tools

get_model_schema read-only

Fetches the OpenAPI input schema and description for a Replicate model

Use cases

Generating custom images and SVG icons for coding projects

Batch-generating multiple concepts to explore design options

Creating multiple style variants of the same prompt (e.g., watercolor, oil painting)

Invoking arbitrary Replicate models for video generation, image upscaling, etc.

Supported clients

Claude Desktop

Cursor

Cline

Zed

Codex

Listed from the project's documentation, not tested by this site.

Overview

Replicate Flux MCP is an advanced Model Context Protocol (MCP) server that empowers AI assistants to generate high-quality images and vector graphics. By default it uses black-forest-labs/flux-schnell for raster images and recraft-ai/recraft-v3-svg for SVG output. You can override the curated image/SVG models through environment variables or per-tool model_id overrides (from built-in allowlists). It supports batch image generation, variant generation, arbitrary Replicate model invocation, structured output, progress notifications, and works with Claude Desktop, Cursor, Cline, Zed, and other MCP-compatible clients.

Similar servers

DuckDuckGo Search MCP Server 74 · B

MCP server providing web search and content fetching via DuckDuckGo

★ 1.5k · Tools 2 Compare with this →

Basic Memory 72 · B

Your AI never forgets again.

★ 4.1k · Tools 21 Compare with this →

Telegram MCP Server 70 · B

Telegram MCP server powered by Telethon to let MCP clients read chats, manage groups, and send/modify messages, media, contacts, and settings.

★ 1.8k · Tools 76 Compare with this →

Hostinger API MCP Server 70 · B

Official MCP server for Hostinger API.

★ 160 · Tools 100 Compare with this →

Compare with other MCP servers

Source revision a55fab9054ab Data synced 2026-10-12 Read the FMRS scoring method