Replicate Flux

🚀 MCP Protocol: Generate Images with Replicate's FLUX Model and Store in Cloudflare R2

This is a server-side tool based on the Model Context Protocol (MCP) that uses Replicate's FLUX AI model to generate images and uploads them to Cloudflare's R2 storage service. It can work with any MCP-compliant client.

🚀 Quick Start

This tool is a server-side implementation based on the Model Context Protocol (MCP). It uses Replicate's FLUX AI model to generate images and uploads them to Cloudflare's R2 storage service. It can be used in conjunction with any client that supports the MCP protocol.

📦 Installation

1. Download the Project

Download the mcp-replicate-flux project from the following link:

https://github.com/your-username/mcp-replicate-flux.git

2. Configure Environment Variables

Create a .env file and fill in the following content:

REPLICATE_API_TOKEN=your_replicate_token
STORAGE_ENDPOINT=your_r2_endpoint
STORAGE_ACCESS_KEY=your_r2_access_key
STORAGE_SECRET_KEY=your_r2_secret_key
STORAGE_BUCKET=your_bucket_name
STORAGE_DOMAIN=your_domain

3. Start the Server

Run the following command to start the MCP server:

node index.js

✨ Features

• Generate high-quality images using Replicate's FLUX model.
• Upload the generated images to Cloudflare R2 storage service.
• Support interaction with AI clients via the MCP protocol.

📚 Documentation

Project File Structure

mcp-replicate-flux/
├── .env                  # Environment variable configuration file
├── index.js             # MCP server entry file
├── generateImage.js     # Logic file for image generation and uploading to R2
├── test.js              # Test script
└── README.md            # Project documentation

💻 Usage Examples

Basic Usage

const mcpClient = new MCPClient();
await mcpClient.call('replicate-flux', {
    action: 'generateImage',
    params: {
        prompt: 'a beautiful sunset'
    }
});
// Returns the URL of the generated image

🛠️ Troubleshooting

Common Issues

1. Image generation fails: Check if your Replicate API token is valid and if you have available quotas.
2. Upload to R2 fails: Confirm that your R2 credentials and storage bucket permissions are set correctly.
3. Unable to access images: Ensure that the CORS configuration of your R2 storage bucket allows public access.

Contact Information

For technical support, please contact the project maintainer:

Email: support@your-domain.com
GitHub: https://github.com/your-username/mcp-replicate-flux/issues

Protocol Description

The Model Context Protocol (MCP) is a standard protocol for AI model interaction, aiming to achieve interoperability between different AI systems. This server implements a tool for the MCP protocol and can work with all MCP-compliant clients.

For more detailed information about the MCP protocol, please visit:

https://mcp.freeaigen.com/

References

• MCP Protocol Documentation
• Replicate API Documentation
• Cloudflare R2 Documentation
• FLUX AI Model Documentation

📄 License

This project is licensed under the MIT License, as follows:

MIT License

Copyright (c) 2023 your-name

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.