MCP Flux Studio

一个强大的模型上下文协议 (MCP) 服务器，它将 Flux 的高级图像生成能力带到你的 AI 编码助手。此服务器支持将 Flux 的图像生成、操作和控制功能直接集成到 Cursor 和 Windsurf (Codeium) IDE 中。

概述

MCP Flux Studio 弥合了 AI 编码助手和 Flux 强大的图像生成 API 之间的差距，允许将图像生成功能无缝集成到你的开发工作流程中。

特性

• 图像生成

  • 具有精确控制的文本到图像生成
  • 多模型支持 (flux.1.1-pro, flux.1-pro, flux.1-dev, flux.1.1-ultra)
  • 可自定义的宽高比和尺寸

• 图像操作

  • 图像到图像的转换
  • 具有可自定义蒙版的图像修复
  • 分辨率提升和增强

• 高级控制

  • 基于边缘的生成 (canny)
  • 深度感知生成
  • 姿势引导生成

• IDE 集成

  • 完全支持 Cursor (v0.45.7+)
  • 兼容 Windsurf/Codeium Cascade (Wave 3+)
  • 通过 AI 助手实现无缝工具调用

快速开始

1. 先决条件

   • Node.js 18+
   • Python 3.12+
   • Flux API 密钥
   • 兼容的 IDE (Cursor 或 Windsurf)

2. 安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Flux Studio：

npx -y @smithery/cli install @jmanhype/mcp-flux-studio --client claude

手动安装

git clone https://github.com/jmanhype/mcp-flux-studio.git
cd mcp-flux-studio
npm install
npm run build

3. 基本配置

   BFL_API_KEY=your_flux_api_key
   FLUX_PATH=/path/to/flux/installation
   

有关详细的设置说明，包括 IDE 特定的配置和故障排除，请参阅我们的 安装指南。

文档

• 安装指南 - 完整的设置说明
• API 文档 - 详细的工具文档
• 示例用法 - 真实世界的用法示例
• 贡献指南 - 如何贡献

IDE 集成

Cursor (v0.45.7+)

MCP Flux Studio 与 Cursor 的 AI 助手无缝集成：

1. 配置

   • 通过 Settings > Features > MCP 进行配置
   • 支持 stdio 和 SSE 连接
   • 环境变量可以通过包装脚本设置

2. 用法

   • 工具自动提供给 Cursor 的 AI 助手
   • 工具调用需要用户批准
   • 实时反馈生成进度

Windsurf/Codeium (Wave 3+)

与 Windsurf 的 Cascade AI 集成：

1. 配置

   • 编辑 ~/.codeium/windsurf/mcp_config.json
   • 支持基于进程的工具执行
   • 在 JSON 中配置环境变量

2. 用法

   • 通过 Cascade 的 MCP 工具栏访问工具
   • 自动工具发现和加载
   • 与 Cascade 的 AI 功能集成

有关详细的 IDE 特定设置说明，请参阅 安装指南。

用法

服务器提供以下工具：

generate

从文本提示生成图像。

{
  "prompt": "A photorealistic cat",
  "model": "flux.1.1-pro",
  "aspect_ratio": "1:1",
  "output": "generated.jpg"
}

img2img

使用另一张图像作为参考生成图像。

{
  "image": "input.jpg",
  "prompt": "Convert to oil painting",
  "model": "flux.1.1-pro",
  "strength": 0.85,
  "output": "output.jpg",
  "name": "oil_painting"
}

inpaint

使用蒙版修复图像。

{
  "image": "input.jpg",
  "prompt": "Add flowers",
  "mask_shape": "circle",
  "position": "center",
  "output": "inpainted.jpg"
}

control

使用结构控制生成图像。

{
  "type": "canny",
  "image": "control.jpg",
  "prompt": "A realistic photo",
  "output": "controlled.jpg"
}

开发

项目结构

flux-mcp-server/
├── src/
│   ├── index.ts          # 主要服务器实现
│   └── types.ts          # TypeScript 类型定义
├── tests/
│   └── server.test.ts    # 服务器测试
├── docs/
│   ├── API.md           # API 文档
│   └── CONTRIBUTING.md  # 贡献指南
├── examples/
│   ├── generate.json    # 示例工具用法
│   └── config.json      # 示例配置
├── package.json
├── tsconfig.json
└── README.md

运行测试

npm test

构建

npm run build

贡献

请阅读 CONTRIBUTING.md 以了解我们的行为准则以及提交拉取请求的流程。

许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• 模型上下文协议 - 协议规范
• Flux API - 底层图像生成 API