Flux Studio MCP Server

Integrates Flux's image generation capabilities into AI coding assistants, enabling image generation, manipulation, and control directly within IDEs.

Local serverstdioPython 25

What is the Flux Studio MCP server?

If you already use Flux Studio, the flux studio mcp server is the piece that lets your assistant work with it directly. Integrates Flux's image generation capabilities into AI coding assistants, enabling image generation, manipulation, and control directly within IDEs.

What the server does

MCP server that wraps the Flux image generation API. Exposes text-to-image, image-to-image, inpainting, and structural control (canny/depth/pose) as MCP tools over stdio. The server itself is TypeScript; it shells out to a Python CLI (fluxcli.py) for actual API calls.

Installation

The server ships on npm as @smithery/cli, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • generate — prompt
  • img2img — image, prompt, name
  • inpaint — image, prompt
  • control — type (canny/depth/pose), image, prompt
  • Manual — The Manual tool exposed by this server

Credentials and setup notes

Configuration is passed through the environment: BFL_API_KEY, FLUX_PATH. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

This sits in the AI and media services group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Flux Studio's toolset — generate, img2img, inpaint and 2 more — is a fair guide to whether it matches your workflow. It is maintained by jmanhype; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Flux Studio's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
generateprompt
img2imgimage, prompt, name
inpaintimage, prompt
controltype (canny/depth/pose), image, prompt
ManualThe Manual tool exposed by this server.

How to install the Flux Studio MCP server

{
  "mcpServers": {
    "flux-studio": {
      "command": "npx",
      "args": ["-y", "@smithery/cli"],
      "env": {
        "BFL_API_KEY": "your-value",
        "FLUX_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
BFL_API_KEYCredential the server authenticates with.Yes
FLUX_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • Use Flux Studio to generate.
  • Use Flux Studio to img2img.
  • Use Flux Studio to inpaint.

Frequently asked questions

Flux Studio is an MCP (Model Context Protocol) server that brings Flux's powerful image generation capabilities directly into your AI coding assistants like Cursor and Codeium, enabling image generation and manipulation within your IDE.