Replicate Flux MCP

🚀 MCP Server: Replicate - Image Generation Server Based on Model Context Protocol

This is an AI image generation server built on the Model Context Protocol (MCP), supporting image generation using advanced AI models on the Replicate platform. Current implementations include:

• Batch image generation using the Flux Schnell model
• Support for multi-prompt mode
• Image variant generation function
• SVG image generation interface

✨ Features

1. Batch Image Generation (generate_multiple_images)

It can generate multiple images at once based on multiple different prompts.

{
  "prompts": [
    "A serene mountain lake at sunset", 
    "A bustling city street at night", 
    "A peaceful garden in spring"
  ]
}

2. Multi-Prompt Mode

It supports processing multiple image generation requests simultaneously, and each request can specify different parameters.

{
  "requests": [
    {
      "modelId": "black-forest-labs/flux-schnell",
      "prompt": "A futuristic city skyline at night",
      "width": 1024,
      "height": 512
    },
    {
      "modelId": "recraft-ai/recraft-v3-svg", 
      "prompt": "A character portrait in anime style", 
      "style": "anime"
    }
  ]
}

3. Image Variant Batch Generation (generate_image_variants)

It can generate multiple different variants based on a specified prompt.

{
  "prompt": "A futuristic city skyline at night",
  "num_variants": 4,
  "seed": 42
}

4. SVG Image Support

It provides high-quality SVG image generation capabilities through the Recraft V3 SVG model.

🔧 Technical Details

• Model Context Protocol (MCP) SDK - Provides basic server functions, such as tool and resource management
• Replicate API - Implements the AI model call interface
• TypeScript - Ensures code type safety
• Zod - Performs strict runtime data validation

📚 Documentation

Configuration Parameters

Configure by modifying the CONFIG object in src/config/index.ts:

const CONFIG = {
  serverName: "replicate-flux-mcp",
  serverVersion: "0.1.2", 
  imageModelId: "black-forest-labs/flux-schnell",
  svgModelId: "recraft-ai/recraft-v3-svg",
  pollingAttempts: 25,
  pollingInterval: 2000, // ms
};

Typical Application Scenarios

Multi-Prompt Example	Prompt Variant Example

💻 Usage Examples

Batch Generate Multiple Images

{
  "prompts": [
    "A red sports car on a mountain road", 
    "A blue sports car on a beach", 
    "A vintage sports car in a city street"
  ]
}

Generate Image Variants

{
  "prompt": "A futuristic city skyline at night",
  "num_variants": 4,
  "seed": 42
}

Troubleshooting

Common problems and solutions:

1. Network connection issues: Please check your internet access permissions and ensure that the server can access the Replicate API.
2. Model loading failure: Confirm that the model ID is correct and that there is an available version on the Replicate platform.
3. Generation timeout: Increase the pollingInterval value or optimize the network environment.

🤝 Contribution Guidelines

Any contributions are welcome! Please submit issues and Pull Requests through the GitHub repository. It is recommended to read the project documentation and code specifications first to ensure that your contributions meet the project requirements.

🔗 Resource Links

• Official Documentation: Model Context Protocol (MCP)
• Replicate Platform: Replicate AI Models
• Open Source Repository: GitHub Repository

📄 License

This project is licensed under the MIT license. Please refer to the LICENSE file for details.