awkoy/replicate-flux-mcp

Free

提供通过 Replicate API 生成图像的能力。

FreeFree tier

Inputs: text

Type

Open Source

Visit Website GitHub (40 stars)

About awkoy/replicate-flux-mcp

Replicate Flux MCP is an advanced Model Context Protocol (MCP) server that enables AI assistants to generate high-quality raster images and vector graphics via Replicate's AI models. By default, it uses black-forest-labs/flux-schnell for image generation and recraft-ai/recraft-v3-svg for SVG output. Users can override models through environment variables or specify a per-call model_id from a curated allowlist. The server includes tools for single image generation, SVG creation, batch image generation, and variant generation, all with structured output via Zod schemas. It integrates seamlessly with MCP-compatible clients like Cursor, Claude Desktop, Smithery, Glama.ai, and Codex, making it easy for developers to produce customized visual assets directly from their AI workflows.

Key Features

Generate high-quality raster images using black-forest-labs/flux-schnell

Create SVG vector graphics with recraft-ai/recraft-v3-svg

Override default models via environment variables or per-call model_id

Batch image generation for producing multiple outputs at once

Variant image generation to explore different versions of a prompt

Structured output with Zod schemas for reliable parsing

Easy integration with Cursor, Claude Desktop, Smithery, Glama.ai, and Codex

Open source and community-driven with GitHub repository

Pros & Cons

Pros

Free and open-source MCP server
Supports both raster and vector output in one tool
Flexible model selection with environment variable and per-call overrides
Native integration with popular development tools like Cursor and Claude Desktop
Batch and variant generation capabilities for efficient workflows
Structured output with TypeScript schemas for reliable integration

Cons

Requires a Replicate API token and internet connection to function
Metadata and performance tied to external Replicate API (latency, model availability)
Model selection limited to a curated allowlist unless environment overrides are used
MCP protocol is relatively new, may require some setup knowledge for integration

Best For

Generating customized images and SVG assets that match specific coding vibes and aesthetic stylesCreating visual assets for development projects, documentation, and blog postsProducing icons, diagrams, and illustrations for software interfacesRapid prototyping of UI elements and design mockupsBatch generating multiple image variants for A/B testing or content creation

FAQ

What is Replicate Flux MCP?

It is an MCP (Model Context Protocol) server that allows AI assistants to generate images and SVGs using Replicate's Flux models, such as black-forest-labs/flux-schnell and recraft-ai/recraft-v3-svg.

How do I get a Replicate API token?

Which models are used by default?

By default, it uses black-forest-labs/flux-schnell for raster image generation and recraft-ai/recraft-v3-svg for SVG output. Both can be overridden via environment variables.

Can I override the model on a per-call basis?

Yes, image tools accept an optional model_id parameter from a built-in allowlist, allowing you to specify a different Replicate model for each request.

How do I integrate it with Cursor?

Create or edit the .cursor/mcp.json file in your project directory with the command 'env REPLICATE_API_TOKEN=YOUR_TOKEN npx -y replicate-flux-mcp'.

How do I integrate it with Claude Desktop?

Edit the mcp.json file in your Claude Desktop configuration directory with the server details and your Replicate API token.