FLUX Image Generator — MCP Tool for Claude

Generate images directly inside Claude using FLUX.1-schnell — one of the best open-source image models available today.

Claude doesn't generate images natively. This tool bridges that gap: install it once and Claude will be able to create images on demand from any conversation.

How it works

This is an MCP server (Model Context Protocol — Anthropic's open standard for extending Claude with external tools). Once installed, Claude detects image requests automatically and calls this server in the background. You just talk to Claude normally.

You: "Generate a photo of a futuristic city at night, 16:9"
Claude: [calls generate_image tool] → saves the image locally and confirms

Related MCP server: FLUX MCP Server

Prerequisites

• Python 3.10+ — check with python3 --version

• Claude Desktop or Claude Code CLI

• HuggingFace account (free) — for your API token

Installation

1. Clone and set up

git clone https://github.com/ZZtopBR/flux-image-mcp.git
cd flux-image-mcp
python3 -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate
pip install -r requirements.txt

2. Get your HuggingFace token

1. Create a free account at huggingface.co

2. Go to Settings → Tokens

3. Create a Read token and copy it

4. Accept the FLUX.1-schnell license

3. Connect to Claude

Claude Code CLI

export HF_TOKEN=hf_your_token_here
claude mcp add flux-image-generator -s user \
  -- /path/to/flux-image-mcp/venv/bin/python \
     /path/to/flux-image-mcp/server.py

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "flux-image-generator": {
      "command": "/path/to/flux-image-mcp/venv/bin/python",
      "args": ["/path/to/flux-image-mcp/server.py"],
      "env": { "HF_TOKEN": "hf_your_token_here" }
    }
  }
}

Restart Claude Desktop. A hammer icon confirms the tool is connected.

Usage

Just ask Claude naturally:

"Generate an image of an astronaut riding a horse on Mars"
"Create a 16:9 wallpaper of a Japanese temple in autumn"
"Draw a minimalist logo for a coffee shop"

Aspect ratios

Images are saved to ~/generated_images/.

Standalone CLI

Works without Claude too:

python generate_image.py "a futuristic city" --size 16:9 --count 2

Troubleshooting

License

MIT

Built with FLUX.1-schnell by Black Forest Labs and MCP by Anthropic.