mcpField
F
FLUX

FLUX

本地服务
github.com/black-forest-labs媒体与设计189 周前更新

关于 FLUX

FLUX 是 Black Forest Labs 的托管 MCP 服务,面向希望在 MCP 客户端中生成和编辑图像、视频的用户。它还支持虚拟试穿、生成历史与提示词指南。

主要功能

  1. 01文本生成图像与图像编辑
  2. 02多参考图像合成与虚拟试穿
  3. 03FLUX 3 视频生成与增强
  4. 04生成变体并浏览历史
  5. 05提供官方提示词指南

适用场景

  1. 01批量生成图像方案
  2. 02通过提示词修改上传图像
  3. 03将静态图或关键帧生成视频
  4. 04从历史结果继续编辑或生成变体

MCP 相关

通过托管的远程服务 https://mcp.bfl.ai 向 MCP 客户端提供 FLUX 图像与视频工具、资源和提示词。采用 OAuth 登录,并可使用生成历史、额度查询及指南。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"flux": {
"command": "npx",
"args": [
"-y",
"mcp-remote"
]
}
}
}
启动命令npx -y mcp-remote

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmmcp-remote

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Black Forest Labs

FLUX MCP

将 FLUX 引入你已在使用的工具。
通过任何兼容 MCP 的客户端生成、编辑和变换 FLUX 图像与视频,并浏览相关内容。

MCP Registry License: MIT Docs

安装 · 展示 · 工具 · 技能 · 示例 · 故障排除


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
  1. 打开 设置 → 连接器。
  2. 点击 添加自定义连接器。
  3. 将名称设为 FLUX,URL 设为 https://mcp.bfl.ai。
  4. 点击 连接,登录并选择用于计费的 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 张编辑风格的人像变体 — 采用不同的光线、色调和氛围。”

README 配图 README 配图 README 配图 README 配图

或只生成一张 — 满足你对单张主视觉图的需求

“一张俯拍航拍照片:浅水沙漠盐池,阳光强烈直射。”

README 配图

直接在聊天中编辑任意图片

“在沙地上加一头骆驼。”

编辑前编辑后
README 配图README 配图
浏览并重用完整的生成历史记录

“向我展示最近生成的 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 提供(参见提示词技巧)。


链接


许可证

MIT © Black Forest Labs

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。