flux-img-mcp

Flux Image MCP Server

This MCP server provides image generation capabilities using the Flux Schnell model on Replicate.

Installation

0. Install the MCP SDK globally:

npm install -g @modelcontextprotocol/sdk@latest

1. Clone this repository to your MCP servers 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 (either 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

The server requires the following environment variable:

• REPLICATE_API_TOKEN: Your Replicate API token. You can get this from your Replicate account settings.

Usage

Once installed and configured, the server provides the following tool:

generate_image

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

Parameters:

• prompt (string, required): Text description of 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:

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

Development

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 for changes to take effect

Error Handling

The server includes comprehensive error handling for:

• Missing API token
• Invalid parameters
• API request failures
• Network issues

Security

• Never commit your Replicate API token to version control
• Always provide the token through environment variables
• The server validates all input parameters before making API requests