flux-image-generator

🚀 FLUX图像生成器MCP服务器

FLUX图像生成器MCP服务器可借助Black Forest Lab的FLUX模型生成图像，采用了最新的MCP SDK（v1.7.0），能为用户提供便捷的图像生成服务。

🚀 快速开始

FLUX图像生成器MCP服务器是一个用于图像生成的工具，借助Black Forest Lab的FLUX模型，可根据文本提示生成高质量图像。以下是使用该服务器的基本步骤：

1. 完成安装（具体安装方法见“📦 安装指南”）。
2. 启动服务器（具体启动命令见“💻 使用示例”）。
3. 调用可用工具生成图像（具体工具使用方法见“💻 使用示例”）。

✨ 主要特性

• 文本生成图像：根据输入的文本提示，生成相应的图像。
• 自定义设置：支持自定义图像维度、提示上采样和安全设置，满足多样化需求。
• 本地保存：可将生成的图像保存到本地。
• 批量生成：支持从多个提示批量生成图像，提高效率。

📦 安装指南

从源码安装

1. 克隆此仓库。
2. 安装依赖：

npm install

3. 基于 .env.example 创建一个 .env 文件，并添加您的 Black Forest Lab API 密钥：

BFL_API_KEY=your_api_key_here

4. 构建项目：

npm run build

使用 npm 安装

npm install -g @modelcontextprotocol/server-flux-image-generator

💻 使用示例

启动 MCP 服务器

使用以下命令启动服务器：

npm start

开发时自动重新编译：

npm run watch

与 MCP 客户端集成

要将此服务器与 MCP 客户端（如 Claude）一起使用，请在客户端配置中添加以下内容：

{
  "mcpServers": {
    "flux-image-generator": {
      "command": "mcp-server-flux-image-generator",
      "env": {
        "BFL_API_KEY": "your_api_key_here"
      }
    }
  }
}

基础用法

generateImage

根据文本提示生成图像，具有可自定义的设置。 参数： | 参数 | 详情 | |------|------| | prompt | 描述图像的文字（字符串，必需） | | width | 图像宽度（以像素为单位，数字，可选，默认值：1024） | | height | 图像高度（以像素为单位，数字，可选，默认值：1024） | | promptUpsampling | 通过上采样提示来增强细节（布尔值，可选，默认值：false） | | seed | 用于可重复结果的随机种子（数字，可选） | | safetyTolerance | 内容moderation容忍度（1 - 5，数字，可选，默认值：3） |

示例：

{
  "prompt": " sunset中的一片宁静湖水，背景是群山",
  "width": 1024,
  "height": 768,
  "promptUpsampling": true,
  "seed": 12345,
  "safetyTolerance": 3
}

quickImage

使用默认设置快速生成图像的简化工具。 参数： | 参数 | 详情 | |------|------| | prompt | 描述图像的文字（字符串，必需） |

示例：

{
  "prompt": "具有飞行汽车的未来城市景观"
}

batchGenerateImages

根据提示列表批量生成多个图像。 参数： | 参数 | 详情 | |------|------| | prompts | 提示列表（最多10个，字符串数组，必需） | | width | 图像宽度（数字，默认值：1024） | | height | 图像高度（数字，默认值：1024） |

示例：

{
  "prompts": [
    " sunset中的一片宁静湖水，背景是群山",
    "未来城市景观中的飞行汽车",
    " prohibited content"
  ],
  "width": 1024,
  "height": 768
}

输出格式

成功响应

{
  "images": [
    {
      "path": "/generated-images/1.png",
      "status": "success"
    },
    {
      "path": "/generated-images/2.png",
      ...
    }
  ]
}

🔧 技术细节

先决条件

• Node.js（v18.0.0 或更高版本）
• Black Forest Lab API 密钥（在 https://api.bfl.ml 获取）

此服务器采用了最新的 MCP SDK（v1.7.0），通过与 Black Forest Lab 的 FLUX 模型交互，实现图像生成功能。在使用时，需要确保 Node.js 版本符合要求，并获取有效的 API 密钥。服务器支持多种自定义设置，可根据用户需求生成不同维度、不同细节程度的图像。同时，支持批量生成图像，提高了图像生成的效率。