mcp-flux-schnell MCP Server

What is mcp-flux-schnell MCP Server?

A TypeScript-based MCP server that generates images from text descriptions using the Flux Schnell model via Cloudflare's Worker API. It is designed for developers who want to add image generation capabilities to MCP-compatible tools like Cursor or Claude.

How to use mcp-flux-schnell MCP Server?

Install the server via Smithery or manually by configuring it in a Cursor project (./.cursor/mcp.json) or globally (~/.cursor/mcp.json). Provide the required environment variables (FLUX_API_URL, FLUX_API_TOKEN, optional WORKING_DIR), then invoke the generate_image tool with a text prompt.

Key features of mcp-flux-schnell MCP Server

• Single generate_image tool to create images from text prompts.
• Supports prompts between 1 and 2048 characters.
• Returns the file path of the generated image.
• Configurable output directory via WORKING_DIR environment variable.
• Can be configured per project or globally in Cursor.

Use cases of mcp-flux-schnell MCP Server

• Generating images on the fly while coding inside an MCP client.
• Adding visual illustrations to documentation or comments from the editor.
• Automating image creation for prototypes or mockups as part of a development workflow.
• Integrating text-to-image generation into AI agent pipelines.

FAQ from mcp-flux-schnell MCP Server

What does the generate_image tool require?

It requires a text prompt of 1–2048 characters and returns the file path to the generated image.

What environment variables must be set?

FLUX_API_URL (the Flux Schnell API endpoint) and FLUX_API_TOKEN (your authentication token) are required. WORKING_DIR is optional and defaults to the current working directory.

How do I install the server on Cursor?

Add a configuration block in .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global), specifying the path to the built index.js and the required environment variables.

Where are generated images saved?

Images are saved in the directory set by the WORKING_DIR environment variable. If not set, they are saved in the current working directory.

Can I install the server automatically via Smithery?

Yes. Run npx -y @smithery/cli install @bytefer/mcp-flux-schnell --client claude to install it for Claude.