generate_image
Generate an image from a text prompt using Flux Schnell model
LABSCO SUMMARY
One tool, and the model behind it is yours to host.
This is a thin bridge rather than an image service: it does not bundle a model or an account, it calls the Cloudflare worker whose URL and token you supply. That means cost and rate limits are whatever your own endpoint charges, and it also means the server is useless until that endpoint exists.
What it is
A small TypeScript server that puts one text-to-image call in front of the Flux Schnell model. It sends your prompt to a Flux Schnell worker API you point it at, writes the resulting image to disk, and answers with the file path.
What you get
- An image generated from a text description of 1 to 2048 characters —
generate_image - The path to the written image file, so the next step in the conversation can open or move it
- Control over where images land, through the optional
WORKING_DIRvariable
Requirements
Your own Flux Schnell endpoint: FLUX_API_URL for the worker URL and FLUX_API_TOKEN for its token, both required. WORKING_DIR is optional and defaults to the current working directory. Runs as a Node process from the built build/index.js; there is also a Smithery install for Claude Desktop. The package is mcp-flux-schnell 0.1.0.
Setup effort
Build from source
USE CASES
01
Getting a placeholder image without leaving the chat
Describe the picture you want and get back a file path you can drop straight into a mockup or a slide.
02
Keeping generated art with the project it belongs to
Point WORKING_DIR at the project folder so every image the agent makes is written where the rest of the assets live, instead of the directory the server happened to start in.
1 tool
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool when we connected.
Requires
- Node.js and npm, to build it
- FLUX_API_URL in your environment
- FLUX_API_TOKEN in your environment
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the one tool definition that rides along on every turn
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/bytefer/mcp-flux-schnell
cd mcp-flux-schnell
npm install
npm run buildMCP Clients
Cursor
CURSOR · JSON
{
"mcpServers": {
"mcp-flux-schnell": {
"command": "node",
"args": [
"<YOUR_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_DIR>"
}
}
}
}<YOUR_PATH_TO_MCP_FLUX_SCHNELL>/build/index.js is the full path of build/index.js in your clone (npm run build creates it). Set FLUX_API_URL to the URL of your Flux Schnell worker API and FLUX_API_TOKEN to its token. WORKING_DIR is optional: set it to the folder images should be saved in, or delete that line to save them in the current working directory.
