Use This MCP server To

Generate images from text prompts for creative projects Integrate text-to-image generation into chatbots or assistants Automate visual content creation for marketing materials Create custom illustrations for documentation or blogs Enable dynamic image generation in web applications Prototype AI-generated art concepts quickly Combine with other MCP tools for multimedia workflows

README

mcp-flux-schnell MCP Server

smithery badge

A TypeScript-based MCP server that implements a text-to-image generation tool using the Flux Schnell model. This server integrates with Cloudflare's Flux Schnell worker API to provide image generation capabilities through MCP.

Creating your own Flux Schnell MCP Server is so easy! — Part 1
Creating your own Flux Schnell MCP Server is so easy! — Part 2

Features

Tools

generate_image - Generate images from text descriptions
- Takes a text prompt as input (1-2048 characters)
- Returns the path to the generated image file

Environment Variables

The following environment variables must be configured:

FLUX_API_URL - The URL of the Flux Schnell API endpoint
FLUX_API_TOKEN - Your authentication token for the Flux Schnell API
WORKING_DIR (optional) - Directory where generated images will be saved (defaults to current working directory)

Development

Install dependencies:

npm install
# or
pnpm install

Build the server:

npm run build
# or
pnpm build

Installation

Installing via Smithery

To install Flux Schnell Image Generator for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @bytefer/mcp-flux-schnell --client claude

Cursor Configuration

There are two ways to configure the MCP server in Cursor:

Project Configuration

For tools specific to a project, create a .cursor/mcp.json file in your project directory:

{
  "mcpServers": {
    "mcp-flux-schnell": {
      "command": "node",
      "args": ["/path/to/mcp-flux-schnell/build/index.js"],
      "env": {
        "FLUX_API_URL": "your flux api url",
        "FLUX_API_TOKEN": "your flux api token",
        "WORKING_DIR": "your working directory"
      }
    }
  }
}

This configuration will only be available within the specific project.

Global Configuration

For tools that you want to use across all projects, create a ~/.cursor/mcp.json file in your home directory with the same configuration:

{
  "mcpServers": {
    "mcp-flux-schnell": {
      "command": "node",
      "args": ["/path/to/mcp-flux-schnell/build/index.js"],
      "env": {
        "FLUX_API_URL": "your flux api url",
        "FLUX_API_TOKEN": "your flux api token",
        "WORKING_DIR": "your working directory"
      }
    }
  }
}

This makes the MCP server available in all your Cursor workspaces.

mcp-flux-schnell FAQ

How do I configure environment variables for mcp-flux-schnell?

You must set the required environment variables such as the Cloudflare API keys to enable the Flux Schnell worker integration.

What input formats does the generate_image tool accept?

It accepts text prompts ranging from 1 to 2048 characters to generate images.

What does the generate_image tool return?

It returns the path to the generated image file accessible via the MCP server.

Can I customize the image generation parameters?

Customization depends on the Flux Schnell API capabilities; check the API docs for supported options.

Is mcp-flux-schnell compatible with multiple LLM providers?

Yes, it works with MCP clients using models like OpenAI, Claude, and Gemini to provide image generation in workflows.

How do I deploy mcp-flux-schnell?

Deploy it as a TypeScript MCP server with access to Cloudflare Flux Schnell API credentials in your environment.

Does mcp-flux-schnell support real-time image generation?

Yes, it provides near real-time image generation through the Flux Schnell worker API integration.