FLUX图像生成器 MCP 服务器

一个用于使用 Black Forest Lab 的 FLUX 模型生成图像的 MCP（模型上下文协议）服务器。采用最新的 MCP SDK（v1.7.0）。

功能

• 根据文本提示生成图像
• 自定义图像维度、提示上采样和安全设置
• 本地保存生成的图像
• 批量从多个提示生成图像

先决条件

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

安装

从源码

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（数字，可选，默认值：3）：内容 moderation 容忍度（1-5）

示例：

{
  "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",