SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI图像工具FluxMCP

FluxMCP

FluxMCP 是一个基于 Model Context Protocol（MCP）的服务器，用于通过 AceDataCloud 平台调用 Black Forest Labs 的 Flux 模型进行 AI 图像生成与编辑。它支持从 Claude、Cursor 等兼容 MCP 的客户端直接生成和编辑图像，提供文本生成图像、上下文感知的图像编辑、异步任务管理与批量状态查询、内置模型选择与提示词指导，并支持 stdio（本地）和 HTTP（远程/云端）两种传输模式，提供 Docker 容器化及 K8s 部署清单，HTTP 模式下使用 Bearer token 认证并实现按请求隔离。

访问官网

工具介绍

FluxMCP 是一个 Model Context Protocol（MCP）服务器，用于通过 AceDataCloud 平台使用 Flux 模型进行 AI 图像生成和编辑。用户可以从 Claude、Cursor 或任何兼容 MCP 的客户端直接生成和编辑图像。

主要能力：

  • 图像生成：使用 6 种 Flux 模型（包括 flux-dev、flux-pro、flux-kontext）根据文本提示生成图像。
  • 图像编辑：使用上下文感知的 Flux Kontext 模型编辑现有图像。
  • 任务管理：跟踪异步生成任务并支持批量状态查询。
  • 模型指南：内置模型选择和提示词编写指导。
  • 双传输模式：支持 stdio（本地）和 HTTP（远程/云端）模式。
  • Docker 就绪：提供容器化及 K8s 部署清单。
  • 安全：HTTP 模式下使用 Bearer token 认证，并实现按请求隔离。

使用方式： 用户可以通过托管 OAuth、API token 或本地 stdio 连接。托管端点为 https://flux.mcp.acedata.cloud/mcp。托管服务支持 OAuth 元数据和动态客户端注册（DCR），DCR 注册的是客户端应用而非 API 密钥。OAuth 登录后客户端发送 Bearer token，可能需要复用或创建账户的 API 凭证。浏览器登录仍需 AceDataCloud 账户。托管服务可能计费，实际操作前应查看当前服务文档和显示的价格。不要为同一服务器同时配置 OAuth 登录和固定 Authorization 头。

各客户端配置示例：

  • Claude 和 Claude Desktop 聊天：在 Customize → Connectors → Add custom connector 中添加远程自定义连接器，输入 https://flux.mcp.acedata.cloud/mcp，选择登录，若 Claude 询问如何注册 OAuth 客户端则选择自动注册，完成同意。Claude Desktop 的本地 claude_desktop_config.json 是独立设置。
  • Claude Code：运行 claude mcp add --transport http --scope user flux https://flux.mcp.acedata.cloud/mcp，然后 claude mcp login flux。检查 /mcp。
  • Cursor：添加仅包含 https://flux.mcp.acedata.cloud/mcp 的远程服务器。项目配置合并到 <project>/.cursor/mcp.json；个人使用则用 ~/.cursor/mcp.json。
  • VS Code / Copilot：运行 MCP: Add Server，选择 HTTP，输入 https://flux.mcp.acedata.cloud/mcp，然后完成浏览器登录。新的可移植工作区配置使用 <project>/.mcp.json；VS Code 特定格式使用 <project>/.vscode/mcp.json 或用户配置文件。检查 MCP: List Servers。
  • Codex：运行 codex mcp add flux --url https://flux.mcp.acedata.cloud/mcp，然后 codex mcp login flux。用户设置位于 ~/.codex/config.toml。

托管 API token 方式： 打开 Ace Data Cloud → Applications，登录或注册账户。找到 General 应用，若未创建则选择 Initialize General Application。通用密钥可使用账户可用的服务；专用应用的密钥仅限于其服务。检查所需服务/模型访问权限和当前定价。从应用卡片复制 API Key，或打开 Keys / Manage Keys → Create 创建单独密钥。创建密钥时，查看 Expiration Time、Set Usage Limitation 和 Allowed APIs，仅启用所需限制，允许将调用的操作，然后点击 Create 并从密钥列表复制 token。任务查询不授予提交生成的权限。确认应用余额能覆盖首次请求。 仅复制 token 值，不要带引号、空格或 Bearer。API Key / API Token 字段期望原始值；只有手动配置的 HTTP Authorization 头需要 Bearer 前缀。platform-... 账户管理 token 不能替代生成 API 密钥。将密钥保存在客户端凭证存储或环境变量中。切勿放入提示词、共享工作流、截图或 Git 提交。若认证失败，检查完整复制值、应用/服务访问、过期时间、使用限制和余额，然后再创建新密钥。

本地安装： 安装包并为本地进程提供 API token。对于 Claude Desktop 本地 MCP，将此条目合并到开发者设置打开的文件中（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）。uvx 需要 uv 在 PATH 中。保持此用户级文件私密。自托管 HTTP 使用 mcp-flux-pro --transport http --port 8000；仅通过适当的网络和 TLS 控制暴露。本地执行仍调用 AceDataCloud API。

使用前检查：

  • https://flux.mcp.acedata.cloud/health 返回 {"status":"ok"} 仅检查端点可达性。
  • 确认 MCP 客户端加载工具。flux_list_models 是参考工具，不验证下游 API 访问或余额。
  • 若需完整 API 检查，在查看当前服务文档和显示价格后，使用自己的有效输入调用 flux_generate_image。若结果包含任务 ID，对同一 ID 调用 flux_get_task 直到最终成功或失败。不要仅为检查进度而重新提交操作。
  • 401 错误：检查客户端使用的认证路由以及 token 或 OAuth 会话是否有效。403 可能表示账户权限或内容审核失败；阅读返回的错误。余额不足和下游服务故障需要各自诊断。列出的工具或提交的任务不证明成功结果。

可用工具和提示： 提供可用工具和可用提示，支持生成图像、检查任务状态。

支持模型： 支持 flux-dev、flux-pro、flux-kontext 等 6 种 Flux 模型。

环境变量： 此 MCP 服务器使用 AceDataCloud Flux API：

  • POST /flux/images — 生成或编辑图像
  • POST /flux/tasks — 查询任务状态（单个或批量） 完整 API 文档：platform.acedata.cloud

视频生成： 使用 flux_generate_video 以结构化请求支持 t2v、i2v、v2v 或 draft_enhance。例如：{"mode":"t2v","prompt":"Waves at sunset","duration":5,"resolution":"hd","generate_audio":false}。图像模式需要关键帧；视频模式需要 start_video。草稿增强使用拥有的平台 draft_task_id，并要求临时草稿缓存仍可用。视频生成使用 POST /flux/videos，action=generate（默认）和 mode=t2v/i2v/v2v/draft_enhance。每种生成模式接受各自的字段。工具默认异步返回任务 ID；使用 flux_get_task 获取最终视频。在请求中设置 async=false 可同步等待。

许可：MIT License — 详见 LICENSE。 相关：AceDataCloud Platform、Flux by Black Forest Labs。

同类工具

查看分类