关于 FLUX
FLUX 是 Black Forest Labs 的托管 MCP 服务,面向希望在 MCP 客户端中生成和编辑图像、视频的用户。它还支持虚拟试穿、生成历史与提示词指南。
主要功能
- 01文本生成图像与图像编辑
- 02多参考图像合成与虚拟试穿
- 03FLUX 3 视频生成与增强
- 04生成变体并浏览历史
- 05提供官方提示词指南
适用场景
- 01批量生成图像方案
- 02通过提示词修改上传图像
- 03将静态图或关键帧生成视频
- 04从历史结果继续编辑或生成变体
MCP 相关
通过托管的远程服务 https://mcp.bfl.ai 向 MCP 客户端提供 FLUX 图像与视频工具、资源和提示词。采用 OAuth 登录,并可使用生成历史、额度查询及指南。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
FLUX MCP
将 FLUX 引入你已在使用的工具。
通过任何兼容 MCP 的客户端生成、编辑和变换 FLUX 图像与视频,并浏览相关内容。
FLUX MCP 服务将完整的 FLUX 工具包——文生图、图像编辑、多参考图合成、虚拟试穿、FLUX 3 视频、变体和历史记录——提供给任何支持模型上下文协议的客户端。并行生成多个选项,通过提示词编辑附加图像,在照片中试穿服装,为静态图像添加动画并生成带音频片段,还可以从喜欢的结果继续创建变体。无需编写 API 代码,也无需在对话中粘贴密钥。
- 托管式远程服务,仅支持 OAuth。 连接到
https://mcp.bfl.ai。使用 BFL 账户登录,选择计费组织即可。 - 支持所有 FLUX.2 模型。 Pro、Max、Klein(4B 和 9B)、Flex。客户端会为任务选择合适的模型。
- FLUX 3 视频。 文生视频、根据关键帧生成图生视频,以及带同步音频的视频续接;还包含草稿预览。
- 专为聊天打造。 每条提示词最多并行处理 8 张图像。编辑附加图像。浏览并复用历史记录。
- 专业提示词指南。 BFL 官方指南涵盖专门的图像与 FLUX 3 工作流。
- 费用直接支付给 BFL。 没有中间商,也没有共享配额。当前价格:bfl.ai/pricing。
安装
Claude — 桌面端与 claude.ai
- 打开 设置 → 连接器。
- 点击 添加自定义连接器。
- 将名称设为
FLUX,URL 设为https://mcp.bfl.ai。 - 点击 连接,登录并选择用于计费的 BFL 组织。
Claude Code
claude mcp add --transport http FLUX https://mcp.bfl.ai
首次使用时会打开浏览器进行 OAuth 授权。令牌会自动刷新。
Cursor
一键添加: 添加到 Cursor — 打开 Cursor,并预先填入 FLUX 服务。
手动添加 — 添加到 .cursor/mcp.json:
{
"mcpServers": {
"FLUX": {
"url": "https://mcp.bfl.ai"
}
}
}
Codex
codex mcp add flux --url https://mcp.bfl.ai
codex mcp login flux
或者将以下内容追加到 ~/.codex/config.toml:
[mcp_servers.flux]
url = "https://mcp.bfl.ai"
Windsurf
编辑 ~/.codeium/windsurf/mcp_config.json(注意,Windsurf 使用 serverUrl,而非 url):
{
"mcpServers": {
"FLUX": {
"serverUrl": "https://mcp.bfl.ai"
}
}
}
从 Cascade 面板重新加载插件。首次调用 FLUX 时会打开浏览器进行登录。
其他 MCP 客户端(通过 mcp-remote 使用 stdio 桥接)
适用于支持 stdio MCP,但无法自行处理 OAuth 流程的客户端 — 例如 Hermes(Nous Research)以及类似的、只接受静态 bearer token 的工具:
{
"mcpServers": {
"FLUX": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.bfl.ai"]
}
}
}
mcp-remote 会打开浏览器进行 OAuth 授权,将令牌缓存到 ~/.mcp-auth/,并自动刷新令牌。
示例
在一条提示词中生成一组备选方案
“生成 4 张编辑风格的人像变体 — 采用不同的光线、色调和氛围。”
或只生成一张 — 满足你对单张主视觉图的需求
“一张俯拍航拍照片:浅水沙漠盐池,阳光强烈直射。”
直接在聊天中编辑任意图片
“在沙地上加一头骆驼。”
| 编辑前 | 编辑后 |
![]() | ![]() |
浏览并重用完整的生成历史记录
“向我展示最近生成的 FLUX 图片。”
每次生成都会保存。点击任意缩略图即可编辑、生成变体或下载。只需点击一次,即可基于任意历史图片生成分支变体。
工具
客户端会根据你的提示词选择要调用的工具——你无需按名称调用它们。
| 工具 | 功能 |
|---|---|
generate_image | 并行生成 1–8 张图像。支持文生图、编辑、多参考图合成、风格迁移、类局部重绘编辑和扩图——全部通过提示词完成。 |
vto | 虚拟试穿——根据参考图,为人物(或宠物)穿上服装、帽子、太阳镜、鞋子、包或任何可穿戴物品。保留面部、头发和姿势;仅更换穿戴的物品。 |
generate_video | 使用 FLUX 3 并行生成 1–4 个视频——支持文生视频、根据关键帧进行图生视频,或续写现有视频。时长为 5–20 秒,音画同步。 |
enhance_video | 以完整画质重新渲染草稿视频——采用你选定草稿的相同构图、种子和提示词方案。 |
generate_variations | 根据之前生成的图像(通过 request_id 标识),沿着相同方向生成 N 张图像。默认生成 4 张,最多 8 张。 |
get_history | 以缩略图网格列出近期生成内容,并提供每个缩略图的变体 / 编辑 / 复制 / 下载操作。支持键集分页和日期筛选。 |
get_credits | 返回你剩余的 BFL 点数余额。 |
list_skills | 列出官方的 BFL 提示词指南——图像最佳实践、视频指导、音频和对话、关键帧、产品广告、档案风格和 API 集成。 |
get_skill | 按名称获取一份指南。较长的指南会返回简介和章节索引;请获取任务所需的章节。 |
模型
generate_image 可用的模型:
| 模型 | 适用场景 |
|---|---|
flux2_pro_preview (默认) | 日常工作——质量与速度的最佳平衡 |
flux2_max | 主视觉图、最终素材——最高质量 |
flux2_klein_9b_preview | 更快地迭代,最多支持 4 张输入图像 |
flux2_klein_4b | 速度最快的选项 |
flux2_flex | 排版和清晰可读的文字 |
完整目录、各模型的参考图数量限制、FLUX 工具(vto)和 FLUX 3 视频也作为 bfl://models MCP 资源提供。
视频
generate_video 可渲染 24fps、时长为 5–20 秒且带同步音频的 MP4 片段,每次调用最多可并行处理 4 个。每个请求使用以下三种模式之一:
| 模式 | 输入 | 结果 |
|---|---|---|
t2v | 仅提示词 | 根据描述生成的片段 |
i2v | 提示词 + 1–10 张关键帧图像 | 一张关键帧会从其精确的首帧开始为静态画面添加动画;两张关键帧会衔接首帧和尾帧;3–10 张关键帧会均匀分布在片段中,组成分镜(必须显式设置 duration) |
v2v | 提示词 + 源视频 | 延续源视频的最后几秒,并包含音频 |
- 提示词使用自然语言撰写。 FLUX 3 会分析提示词,并在渲染前规划生成内容——描述场景、动作和声音。视频不支持种子或模型参数。
- 关键帧可引用先前结果(
request_id)、上传的图像或公开 URL。可选的逐帧时间戳(以秒为单位,按升序排列——要么为所有关键帧都设置,要么都不设置)可固定片段中的精确位置;当duration设为auto时,片段会持续到最后一个时间戳(最长 20 秒)。 v2v的源视频可以是先前generate_video的结果、上传的最大 50 MB 的 MP4,或公开的 MP4 URL。- 格式控制。
duration:5–20 秒或auto(默认值)。aspect_ratio:auto(默认值)、21:9、2:1、16:9、4:3、1:1、3:4或9:16。resolution:hd(默认值,相当于 704p)或fhd(由视频升频器在相当于 1080p 的画布上完成)。generate_audio:默认开启。 - 草稿是探索的好方法。
draft: true会快速渲染精确计划生成内容的低步数预览(仅限hd)。批量生成低成本草稿,选出最佳结果后,通过其request_id使用enhance_video以完整质量重新渲染。 - 渲染需要几分钟——较长片段最长约需一小时。工具会立即返回一个待处理的
request_id;即使关闭聊天,结果也会保留并自动继续处理。 - 视频功能目前不支持基于参考的条件控制(身份和动作参考);之后会推出专用的
r2v模式。
提示词技巧
该服务提供来自 black-forest-labs/skills 的专业提示词指南,并通过三种方式提供,因此每个客户端至少都能使用其中一种。这些指南涵盖特定工作流;目前尚未提供通用的 FLUX 3 提示词指南:
- 工具 —
list_skills和get_skill(name)。适用于所有客户端,包括 ChatGPT。 - 资源 — 面向带资源选择器的客户端(Claude、Cursor)的
bfl://skills/<name>。 - 提示词 — 面向支持提示词命令的客户端(例如
skill_flux_image_best_practices)提供的skill_<name_with_underscores>斜杠提示词。
可以询问 “你有哪些 FLUX 技能?”,也可以直接请求特定内容,例如产品广告、Super 8 胶片画面或对白指导。生成工具会在客户端编写提示词之前,指引其查看相应指南。
提示词示例
连接 FLUX 后,可以在客户端中尝试以下提示词:
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.
提示词技巧
- 把主体放在最前面。 首先描述最重要的物体、人物或场景。
- 描述光线。 “柔和的黄金时刻光线” 或 “阴天漫射的影棚光” 能为模型提供有效指引。
- 使用十六进制颜色值。
#FF6B6B(珊瑚粉)比 “偏粉的红色” 更精确。 - 将画面中的文字加上引号。 为排版文字、标签、海报和标牌使用精确的引号内容。
- 避免使用负面提示词。 FLUX 会响应你描述的内容,而不是一系列需要避免的内容。
- 根据结果迭代。 使用 Variations 获取其他选项,或使用 Edit 持续优化生成的图像。
该服务提供面向特定工作流的专业指南。目前尚未提供通用的 FLUX 3 提示词指南。
故障排除
连接后未显示工具
- Claude Desktop / claude.ai:设置 → 连接器,确认 FLUX 显示为已连接。如果连接失败却没有提示,请移除后重新添加——确保未阻止弹出窗口,以便打开 OAuth 窗口。
- Claude Code:
claude mcp list应显示该服务。 - Codex:
codex mcp list应显示flux。添加后启动新的 Codex 会话。 - 快速冒烟测试:让客户端 “检查我的 BFL 额度”。
刷新工具或重新连接服务
- Claude.ai / Desktop:设置 → 连接器 → 关闭再开启 FLUX,或点击重新连接。
- Claude Code:
/mcp可查看状态并重新授权。完整重建:claude mcp remove FLUX claude mcp add --transport http FLUX https://mcp.bfl.ai - Codex:
codex mcp login flux。完整重建:codex mcp remove flux codex mcp add flux --url https://mcp.bfl.ai - **mcp-remote 客户端:**运行
rm -rf ~/.mcp-auth,然后重启客户端以强制进行新的 OAuth 授权。
身份验证或账单错误
- 确保你在 bfl.ai 拥有 BFL 账户。
- 断开并重新连接连接器,以重新进行 OAuth 授权。
- 检查所选组织是否有足够的额度。
- 让客户端检查你的 BFL 额度,以确认余额。
生成过程一直在加载
大批量生成、FLUX.2 [max] 或复杂编辑所需时间会比小规模生成更长。可视化 MCP 客户端会自动更新图像视图。
视频渲染需要几分钟——长片段最长约需一小时。系统会立即返回待处理请求并自动继续,即使你关闭聊天,稍后再回来也一样。
附加图像或视频编辑失败
你的 MCP 客户端需要获得将附加媒体上传到 BFL 的权限。如果客户端阻止沙盒向外发起 HTTPS 请求,请允许 *.bfl.ai,或改为传入公开 URL。视频仅支持 MP4,大小上限为 50 MB。
切换计费组织
在客户端中断开 FLUX 连接器,然后重新连接。OAuth 流程会再次提示你选择组织。
Agent Skills(配套仓库)
MCP 和 Agent Skills 解决的是不同问题:
| MCP(本仓库) | Agent Skills | |
|---|---|---|
| 功能 | 直接在聊天中生成、编辑、变换和浏览图像 | 教会你的编码 Agent 如何编写 FLUX API 代码 |
| 适用场景 | 在 Claude 或其他 MCP 客户端中进行创作 | 构建调用 FLUX API 的应用 |
两者都使用。它们相辅相成,skills 仓库中的提示词指南也会直接通过 MCP 提供(参见提示词技巧)。
链接
- 文档 — docs.bfl.ai
- 定价 — bfl.ai/pricing
- 状态 — status.bfl.ai
- Black Forest Labs — bfl.ai
许可证
MIT © Black Forest Labs
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。
