awkoy/replicate-flux-mcp

English | 中文
**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, and image tools also accept a per-call model_id override from the built-in allowlist.
📑 Table of Contents
- Getting Started & Integration
- Setup Process
- Cursor Integration
- Claude Desktop Integration
- Smithery Integration
- Glama.ai Integration
- Codex Integration
- Features
- Documentation
- Available Tools
- Available Resources
- Available Prompts
- Structured Output
- Environment Variables
- Development
- Testing
- Technical Details
- Troubleshooting
- Contributing
- License
- Resources
- Examples
🚀 Getting Started & Integration
Setup Process
1. **Obtain a Replicate API Token**
- Sign up at Replicate
- Create an API token in your account settings
2. **Choose Your Integration Method**
- Follow one of the integration options below based on your preferred MCP client
3. **Ask Your AI Assistant to Generate an Image**
- Simply ask naturally: "Can you generate an image of a serene mountain landscape at sunset?"
- Or be more specific: "Please create an image showing a peaceful mountain scene with a lake reflecting the sunset colors in the foreground"
4. **Explore Advanced Features**
- Try different parameter settings for customized results
- Experiment with SVG generation using generate_svg
- Use batch image generation or variant generation features
Cursor Integration
Method 1: Using mcp.json
1. Create or edit the .cursor/mcp.json file in your project directory:
2. Replace YOUR_TOKEN with your actual Replicate API token
3. Restart Cursor to apply the changes
Method 2: Manual Mode
1. Open Cursor and go to Settings
2. Navigate to the "MCP" or "Model Context Protocol" section
3. Click "Add Server" or equivalent
4. Enter the following command in the appropriate field:
5. Replace YOUR_TOKEN with your actual Replicate API token
6. Save the settings and restart Cursor if necessary
Claude Desktop Integration
1. Create or edit the mcp.json file in your configuration directory:
2. Replace YOUR_TOKEN with your actual Replicate API token
3. Restart Claude Desktop to apply the changes
Smithery Integration
This MCP server is available as a hosted service on Smithery, allowing you to use it without setting up your own server.
1. Visit Smithery and create an account if you don't have one
2. Navigate to the Replicate Flux MCP server page
3. Click "Add to Workspace" to add the server to your Smithery workspace
4. Configure your MCP client (Cursor, Claude Desktop, etc.) to use your Smithery workspace URL
For more information on using Smithery with your MCP clients, visit the Smithery documentation.
Glama.ai Integration
This MCP server is also available as a hosted service on Glama.ai, providing another option to use it without local setup.
1. Visit Glama.ai and create an account if you don't have one
2. Go to the Replicate Flux MCP server page
3. Click "Install Server" to add the server to your workspace
4. Configure your MCP client to use your Glama.ai workspace
For more information, visit the Glama.ai MCP servers documentation.
Codex Integration
Add the server to ~/.codex/config.toml:
Replace the env values as needed. If you omit REPLICATE_IMAGE_MODEL_ID / REPLICATE_SVG_MODEL_ID, the server uses black-forest-labs/flux-schnell for images and recraft-ai/recraft-v3-svg for SVGs.
Curated tools validate model overrides against built-in allowlists:
- **Image generation**: black-forest-labs/flux-schnell, google/imagen-4, black-forest-labs/flux-kontext-pro, ideogram-ai/ideogram-v3-turbo, black-forest-labs/flux-1.1-pro, black-forest-labs/flux-dev
- **SVG generation**: recraft-ai/recraft-v3-svg
- **Legacy run_model extras**: minimax/video-01, luma/reframe-video, topazlabs/video-upscale, topazlabs/image-upscale, szcho/codeformer, tencentarc/gfpgan