flux-mcp

KO | EN

gitlite — search

#ai-agents #gemini #c #monitoring #video #mcp #pdf #dotnet #data-science #nextjs

(★ 9)

Official FLUX MCP server. Generate, edit, vary, and browse FLUX images from any MCP client.

파일 탐색기

ZIP 다운로드

- - bug.yml
  - config.yml
  - feature.yml
- CODEOWNERS
- PULL_REQUEST_TEMPLATE.md
- demo.mp4
- logo-400.png
- social-preview.jpg
.gitignore
CONTRIBUTING.md
LICENSE
README.md
server.json

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Bring FLUX into the tools you already use. 
 Generate, edit, vary, and browse FLUX and videos from any MCP-compatible client.

<a href="#install">Install</a> ·
 <a href="#showcase">Showcase</a> ·
 <a href="#tools">Tools</a> ·
 <a href="#prompting-skills">Skills</a> ·
 <a href="#example-prompts">Examples</a> ·
 <a href="#troubleshooting">Troubleshooting</a>

---

The **FLUX MCP server** exposes the full FLUX toolkit — text-to-image, image editing, multi-reference composition, virtual try-on, FLUX 3 video, variations, and history — to any client that speaks the [Model Context Protocol](https://modelcontextprotocol.io). Generate options in parallel, edit attached images through prompts, try garments on a photo, animate stills into clips with audio, and branch into variations from any result you like. No API code, no keys pasted into the conversation.

- **Hosted, remote, OAuth-only.** Connect to `https://mcp.bfl.ai`. Sign in with your BFL account, pick the org to bill — done.
- **Every FLUX.2 model.** Pro, Max, Klein (4B & 9B), Flex. Your client picks the right one for the task.
- **FLUX 3 video.** Text-to-video, image-to-video from keyframes, and video continuation with synchronized audio, draft previews included.
- **Built for chat.** Up to 8 images in parallel per prompt. Edit attached images. Browse and reuse history.
- **Specialist prompting guides.** Official BFL guides cover focused image and FLUX 3 workflows.
- **You pay BFL directly.** No middleman, no shared quotas. Current rates: [bfl.ai/pricing](https://bfl.ai/pricing).

---

## Install

<details open>
<summary>Claude — Desktop &amp; claude.ai</summary>

1. Open [Settings → Connectors](https://claude.ai/settings/connectors).
2. Click **Add custom connector**.
3. Name it `FLUX`, URL `https://mcp.bfl.ai`.
4. Click **Connect**, sign in, choose the BFL organization to bill.

</details>

<details>
<summary>Claude Code</summary>

```bash
claude mcp add --transport http FLUX https://mcp.bfl.ai
```

A browser opens on first use for OAuth. Tokens refresh automatically.

</details>

<details>
<summary>Cursor</summary>

**One-click:** [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=FLUX&config=eyJ1cmwiOiJodHRwczovL21jcC5iZmwuYWkifQ==) — opens Cursor with the FLUX server pre-filled.

**Manual** — add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "FLUX": {
      "url": "https://mcp.bfl.ai"
    }
  }
}
```

</details>

<details>
<summary>Codex</summary>

```bash
codex mcp add flux --url https://mcp.bfl.ai
codex mcp login flux
```

Or append to `~/.codex/config.toml`:

```toml
[mcp_servers.flux]
url = "https://mcp.bfl.ai"
```

</details>

<details>
<summary>Windsurf</summary>

Edit `~/.codeium/windsurf/mcp_config.json` (note Windsurf uses `serverUrl`, not `url`):

```json
{
  "mcpServers": {
    "FLUX": {
      "serverUrl": "https://mcp.bfl.ai"
    }
  }
}
```

Reload plugins from the Cascade panel. The first FLUX call opens a browser for sign-in.

</details>

<details>
<summary>Other MCP clients (stdio bridge via <code>mcp-remote</code>)</summary>

For clients that support stdio MCP but don't handle the OAuth flow themselves — for example **Hermes** (Nous Research) and similar tools that only accept static bearer tokens:

```json
{
  "mcpServers": {
    "FLUX": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.bfl.ai"]
    }
  }
}
```

`mcp-remote` opens a browser for OAuth, caches tokens to `~/.mcp-auth/`, and refreshes them automatically.

</details>

---

## Showcase

### Generate a batch of options in one prompt

> *"Generate 4 editorial portrait variants — varied lighting, palette, and mood."*

### Or just one — when a single hero shot is what you need

> *"A top-down aerial photograph of shallow desert salt pools, intense direct sunlight."*

### Edit any image directly in chat

> *"Add a camel on the sand."*

<table>
 <tr>
 <td align="center">Before</td>
 <td align="center">After</td>
 </tr>
 <tr>
 <td><img src="https://cdn.sanity.io/images/2gpum2i6/production/0dc6f45f41c1e8d2b6606285b4c785d6cfc586e0-1920x1440.jpg"></td>
 <td><img src="https://cdn.sanity.io/images/2gpum2i6/production/627eb91f1da5299c96c1d591b0bbc48368c4e2f2-1920x1440.jpg"></td>
 </tr>
</table>

### Browse and reuse your full generation history

> *"Show me my recent FLUX generations."*

Every generation is saved. Tap any tile to edit, vary, or download. Variations branch off any past image in one click.

---

## Tools

Your client picks which tool to call based on your prompt — you don't need to invoke them by name.

| Tool | What it does |
| --- | --- |
| `generate_image` | Generate **1–8 images in parallel**. Covers text-to-image, edits, multi-reference composition, style transfer, inpainting-style edits, and outpainting — all through prompts. |
| `vto` | **Virtual try-on** — dress a person (or pet) in a garment, hat, sunglasses, shoes, bag, or any wearable from a reference image. Preserves face, hair, and pose; only the worn item changes. |
| `generate_video` | Generate **1–4 videos in parallel** with FLUX 3 — text-to-video, image-to-video from keyframes, or continuation of an existing video. 5–20 seconds, synchronized audio. |
| `enhance_video` | Re-render a **draft** video at full quality — the same composition, seed, and prompt plan as the draft you picked. |
| `generate_variations` | Produce N more images **in the same direction** as a previous generation (identified by `request_id`). Defaults to 4, max 8. |
| `get_history` | List recent generations as a **thumbnail grid** with per-tile Variations / Edit / copy / download actions. Keyset pagination, date filters. |
| `get_credits` | Return your remaining BFL credit balance. |
| `list_skills` | List the official **BFL prompting guides** — image best practices, video direction, audio and dialogue, keyframes, product ads, archival looks, API integration. |
| `get_skill` | Fetch one guide by name. Long guides return an intro plus a section index; fetch the sections the task needs. |

### Models

Available on `generate_image`:

| Model | Use it for |
| --- | --- |
| `flux2_pro_preview` *(default)* | Everyday work — best balance of quality and speed |
| `flux2_max` | Hero shots, final assets — highest quality |
| `flux2_klein_9b_preview` | Faster iterations, up to 4 input images |
| `flux2_klein_4b` | Fastest option |
| `flux2_flex` | Typography and readable text |

The full catalog, per-model reference-image limits, the FLUX Tools (`vto`), and FLUX 3 video are also exposed as the `bfl://models` MCP resource.

### Video

`generate_video` renders 24fps MP4 clips of 5–20 seconds with synchronized audio, up to 4 in parallel per call. Every request uses one of three modes:

| Mode | Input | What you get |
| --- | --- | --- |
| `t2v` | Prompt only | A clip generated from your description |
| `i2v` | Prompt + 1–10 keyframe images | One keyframe animates a still from its exact opening frame; two bridge an opening and a closing frame; 3–10 form a storyboard spread evenly across the clip (explicit `duration` required) |
| `v2v` | Prompt + a source video | A continuation of the source's final seconds, audio included |

- **Prompts are prose** FLUX 3 reasons about the prompt and plans the generation before rendering — describe the scene, the motion, and the sound. There is no seed or model parameter on video.
- **Keyframes** reference a prior result (`request_id`), an uploaded image, or a public URL. Optional per-keyframe timestamps (in seconds, ascending — set on all keyframes or none) pin exact positions in the clip; with `duration` set to `auto`, the clip runs to the last timestamp (20 seconds max).
- **Source videos** for `v2v` are a prior `generate_video` result, an attached MP4 up to 50 MB, or a public MP4 URL.
- **Format controls.** `duration`: 5–20 seconds or `auto` (default). `aspect_ratio`: `auto` (default), `21:9`, `2:1`, `16:9`, `4:3`, `1:1`, `3:4`, or `9:16`. `resolution`: `hd` (default, 704p-class) or `fhd` (finished by a video upsampler on a 1080p-class canvas). `generate_audio`: on by default.
- **Drafts are the way to explore.** `draft: true` renders a fast low-step preview of the exact planned generation (`hd` only). Batch cheap drafts, pick the winner, and `enhance_video` re-renders it at full quality from its `request_id`.
- **Renders take minutes** — long clips up to about an hour. The tool returns immediately with a pending `request_id`; results survive closing the chat and resume automatically.
- **Reference-based conditioning** (identity and motion references) is not part of the video surface; a dedicated `r2v` mode follows later.

---

## Prompting skills

The server ships specialist prompting guides from [black-forest-labs/skills](https://github.com/black-forest-labs/skills) and serves them three ways, so every client gets at least one. These guides cover focused workflows; a general FLUX 3 prompting guide is not included yet:

- **Tools** — `list_skills` and `get_skill(name)`. Works everywhere, including ChatGPT.
- **Resources** — `bfl://skills/<name>` for clients with resource pickers (Claude, Cursor).
- **Prompts** — `skill_<name_with_underscores>` slash-prompts where the client supports them (e.g. `skill_flux_image_best_practices`).

Ask *"what FLUX skills do you have?"*, or just request something specialized like a product ad, Super 8 footage, dialogue direction. The generation tools point your client at the matching guide before it writes the prompt.

---

## Example prompts

Try these in your client once FLUX is connected:

```
Generate 4 editorial portrait variants — varied lighting, palette, and mood.
Use FLUX.2 [pro] at 1440×1792.
```

```
A top-down aerial photograph of shallow desert salt pools at golden hour,
intense direct sunlight, #FF6B6B and #F5E6D3 mineral deposits, FLUX.2 [max].
```

```
[attach an image]
Add a camel on the sand. Preserve the rest of the composition exactly.
```

```
Generate a movie poster with the title "MIRAGE" in 1970s grindhouse type,
high-contrast cyan and orange. Use FLUX.2 [flex].
```

```
[attach a selfie]
Try this on me — a red Nike Tech Fleece hoodie, oversized fit.
```

```
[attach an image]
Animate this into a 10-second clip — slow push-in, wind through the palms,
distant surf.
```

```
Generate 3 draft videos of a paper lantern rising over a night market,
each with a different camera move. I'll enhance the best one.
```

```
Show me my recent FLUX generations.
```

```
[click Variations on a past image]
4 more like this one, vary the lighting.
```

---

## Prompt tips

- **Front-load the subject.** Put the most important object, person, or scene first.
- **Describe lighting.** *"Soft golden hour light"* or *"overcast diffused studio light"* gives the model useful direction.
- **Use hex colors.** `#FF6B6B (coral pink)` is more precise than *"pinkish red"*.
- **Quote rendered text.** Use exact quoted strings for typography, labels, posters, and signs.
- **Avoid negative prompts.** FLUX responds to what you describe, not a list of what to avoid.
- **Iterate from results.** Use Variations for alternatives, or Edit to keep refining a generated image.

The server exposes specialist guides for focused workflows. A general FLUX 3 prompting guide is not included yet.

---

## Troubleshooting

<details>
<summary>Tools don't appear after connecting</summary>

- **Claude Desktop / claude.ai:** Settings → Connectors, confirm FLUX shows as **Connected**. If it failed silently, remove and re-add — make sure pop-ups aren't blocked so the OAuth window can open.
- **Claude Code:** `claude mcp list` should show the server.
- **Codex:** `codex mcp list` should show `flux`. Start a new Codex session after adding.
- Quick smoke test: ask your client *"check my BFL credits"*.

</details>

<details>
<summary>Refreshing tools or reconnecting the server</summary>

- **Claude.ai / Desktop:** Settings → Connectors → toggle FLUX off and on, or click **Reconnect**.
- **Claude Code:** `/mcp` shows status and reauth. Full rebuild:
  ```bash
  claude mcp remove FLUX
  claude mcp add --transport http FLUX https://mcp.bfl.ai
  ```
- **Codex:** `codex mcp login flux`. Full rebuild:
  ```bash
  codex mcp remove flux
  codex mcp add flux --url https://mcp.bfl.ai
  ```
- **mcp-remote clients:** `rm -rf ~/.mcp-auth` and restart the client to force a fresh OAuth.

</details>

<details>
<summary>Authentication or billing errors</summary>

- Make sure you have a BFL account at [bfl.ai](https://bfl.ai).
- Disconnect and reconnect the connector to redo OAuth.
- Check the selected organization has sufficient credits.
- Ask your client to check your BFL credits to verify the balance.

</details>

<details>
<summary>A generation keeps loading</summary>

Large batches, FLUX.2 [max], or complex edits take longer than smaller generations. Visual MCP clients update the image view automatically.

Video renders take minutes — long clips up to about an hour. They return a pending request immediately and resume automatically, even if you close the chat and come back later.

</details>

<details>
<summary>Attached image or video editing fails</summary>

Your MCP client needs permission to upload attached media to BFL. If your client blocks outbound HTTPS from its sandbox, allow `*.bfl.ai` or pass a public URL instead. Video uploads are MP4 only, up to 50 MB.

</details>

<details>
<summary>Switching the billed organization</summary>

Disconnect the FLUX connector in your client and reconnect it. The OAuth flow will prompt you to select an organization again.

</details>

---

## Agent Skills (companion repo)

MCP and Agent Skills solve different problems:

|  | MCP (this repo) | [Agent Skills](https://github.com/black-forest-labs/skills) |
| --- | --- | --- |
| **What it does** | Generates, edits, varies, and browses images directly in chat | Teaches your coding agent how to write FLUX API code |
| **Best for** | Creative work inside Claude or another MCP client | Building applications that call the FLUX API |

Use both. They complement each other and the skills repo's prompting guides are served directly over MCP too (see [Prompting skills](#prompting-skills)).

---

## Links

- **Docs** — [docs.bfl.ai](https://docs.bfl.ai)
- **Pricing** — [bfl.ai/pricing](https://bfl.ai/pricing)
- **Status** — [status.bfl.ai](https://status.bfl.ai)
- **Black Forest Labs** — [bfl.ai](https://bfl.ai)

---

## License

flux-mcp

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

flux-mcp

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README