What is Flux Img Mcp

flux-img-mcp is an MCP server that provides image generation capabilities using the Flux Schnell model on Replicate.

Use cases

Use cases include generating artwork for marketing campaigns, creating illustrations for articles, and producing unique images for social media posts.

How to use

To use flux-img-mcp, first install the MCP SDK globally, clone the repository, build the server, and configure it with your Replicate API token. You can then generate images by sending a text prompt to the ‘generate_image’ tool.

Key features

Key features include the ability to generate images based on text prompts, comprehensive error handling, and easy integration with the MCP SDK.

Where to use

flux-img-mcp can be used in various fields such as digital art creation, content generation for websites, and enhancing visual content in applications.

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