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自动安装Flux Studio for Claude Desktop：

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": "一只超现实的猫",
  "model": "flux.1.1-pro",
  "aspect_ratio": "1:1",
  "output": "generated.jpg"
}

img2img

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

{
  "image": "input.jpg",
  "prompt": "转换为油画",
  "model": "flux.1.1-pro",
  "strength": 0.85,
  6"output": "output.jpg",
  "name": "oil_painting"
}

inpaint

使用遮罩修复图像。

{
  "image": "input.jpg",
  "prompt": "添加花朵",
  "mask_shape": "circle",
  "position": "center",
  "output": "inpainted.jpg"
}

control

使用结构控制生成图像。

{
  "type": "canny",
  "image": "control.jpg",
  "prompt": "一张真实的照片",
  "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