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

---

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

Option	Resolution	Best for
1:1	1024 × 1024	Social media, general use
16:9	1360 × 768	Wallpapers, YouTube thumbnails
9:16	768 × 1360	Phone wallpapers, Stories
4:3	1024 × 768	Presentations, classic photos
3:4	768 × 1024	Portraits, book covers

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

Problem	Solution
Tool not in Claude Code	Run from inside repo folder; check echo $HF_TOKEN
No hammer in Desktop	Quit + relaunch; verify absolute paths; check JSON syntax
HF_TOKEN is not set	Export token or add to Desktop config env block
403 from HuggingFace	Accept the model license on the HF model page
Slow generation	10–30s is normal for the free API

---

License

MIT

---

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