Flux Image MCP Server

Generate images using Replicate's Flux Schnell model.

GitHub

Flux Image MCP Server

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

Installation

  1. 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
  1. Build the server:
npm run build
  1. 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:

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

Servidores relacionados