Flux Image MCP Server

🚀 Flux Image MCP Server for Image Generation with Flux Schnell Model via Replicate

This MCP server leverages the Flux Schnell model on Replicate to provide image generation capabilities.

🚀 Quick Start

📦 Installation

0. Install the MCP SDK globally:

npm install -g @modelcontextprotocol/sdk@latest

1. Clone this repository into your MCP server directory:

cd ~/Documents/Cline/MCP
git clone https://github.com/yourusername/flux-img-mcp.git
cd flux-img-mcp
npm install

2. Build the server:

npm run build

3. Add the server configuration to your MCP settings file (global or workspace):

{
  "mcpServers": {
    "flux-img": {
      "command": "node",
      "args": ["/path/to/flux-img-mcp/build/index.js"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

⚙️ Configuration Requirements

The server requires the following environment variables:

• REPLICATE_API_TOKEN: Your Replicate API token. You can obtain it from Replicate account settings.

💻 Usage Examples

After installation, configure the following tool:

generate_image

Generate an image based on a text prompt using the Flux Schnell model.

Parameters:

• prompt (string, required): Text describing the desired image

Example usage:

<use_mcp_tool>
<server_name>flux-img</server_name>
<tool_name>generate_image</tool_name>
<arguments>
{
  "prompt": "A beautiful sunset over mountains"
}
</arguments>
</use_mcp_tool>

The tool will return a JSON response containing the following:

• status: The status of the generation request
• output: The URL of the generated image (if successful)
• error: Any error information (if failed)

🛠️ Development Guide

To make changes to the server:

1. Modify the source code in src/index.ts
2. Rebuild the server: npm run build
3. Restart the MCP server to apply the changes

❌ Error Handling

The server includes comprehensive error handling for the following scenarios:

• Missing API token
• Invalid parameters
• Failed API requests
• Network issues

🔒 Security Precautions

• Never commit your Replicate API token to a version control system.
• Always provide the token via environment variables.
• The server validates all input parameters to ensure security.