mcpField
M
mcp-flux-schnell MCP Server

mcp-flux-schnell MCP Server

Local
github.com/byteferCloud & Infra5Updated 83w ago
Repository

About mcp-flux-schnell MCP Server

A TypeScript MCP server that lets MCP clients generate images from text using the Flux Schnell model through Cloudflare’s worker API. Generated image files are saved to a configured or default working directory.

Key features

  1. 01Text-to-image generation
  2. 02Flux Schnell model via Cloudflare API
  3. 03Returns generated image file path
  4. 04Configurable output directory

Use cases

  1. 01Generate images from text prompts
  2. 02Save generated images in a project directory

MCP support

Exposes a `generate_image` tool to MCP clients. The tool accepts a text prompt and returns the path to the generated image file.

#flux#mcp#cloudflare#cursor#mcp-servers#mcp-server#fluxschnell

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "flux-schnell": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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.

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.