FLUX 图像生成器 MCP 服务器

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

特征

根据文本提示生成图像
自定义图像尺寸、快速上采样和安全设置
将生成的图像保存在本地
从多个提示批量生成图像

先决条件

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

安装

来自源

克隆此存储库
安装依赖项：

npm install

根据.env.example创建一个.env文件并添加您的 Black Forest Lab API 密钥：

BFL_API_KEY=your_api_key_here

构建项目：

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"
      }
    }
  }
}

可用工具

生成图像

根据具有可自定义设置的文本提示生成图像。

参数：

prompt （字符串，必需）：要生成的图像的文本描述
width （数字，可选，默认值：1024）：图像的宽度（以像素为单位）
height （数字，可选，默认值：1024）：图像的高度（以像素为单位）
promptUpsampling （布尔值，可选，默认值：false）：通过对提示进行上采样来增强细节
seed （数字，可选）：用于可重复结果的随机种子
safetyTolerance （数字，可选，默认值：3）：内容审核容忍度（1-5）

例子：

{
  "prompt": "A serene lake at sunset with mountains in the background",
  "width": 1024,
  "height": 768,
  "promptUpsampling": true,
  "seed": 12345,
  "safetyTolerance": 3
}

快速图像

使用默认设置快速生成图像的简化工具。

参数：

prompt （字符串，必需）：要生成的图像的文本描述

例子：

{
  "prompt": "A futuristic cityscape with flying cars"
}

批量生成图像

根据提示列表生成多个图像。

参数：

prompts （字符串数组，必需）：文本提示列表（最多 10 个）
width （数字，可选，默认值：1024）：图像的宽度
height （数字，可选，默认值：1024）：图像的高度

例子：

{
  "prompts": [
    "A serene lake at sunset",
    "A futuristic cityscape",
    "A magical forest with glowing plants"
  ],
  "width": 1024,
  "height": 768
}

输出格式

所有工具都以这种格式返回响应：

{
  "image_url": "https://storage.example.com/generated_image.jpg",
  "local_path": "/path/to/output/flux_1234567890.png"
}

对于错误：

{
  "error": true,
  "message": "Error description"
}

批处理工具返回：

{
  "total": 3,
  "successful": 2,
  "failed": 1,
  "results": [
    {
      "prompt": "A serene lake at sunset",
      "success": true,
      "image_url": "https://storage.example.com/image1.jpg",
      "local_path": "/path/to/output/flux_batch_1234567890_0.png"
    },
    {
      "prompt": "A futuristic cityscape",
      "success": true,
      "image_url": "https://storage.example.com/image2.jpg",
      "local_path": "/path/to/output/flux_batch_1234567890_1.png"
    },
    {
      "prompt": "Prohibited content",
      "success": false,
      "error": "Content policy violation"
    }
  ]
}

执照

麻省理工学院

FLUX Image Generator MCP Server

Integrations

FLUX 图像生成器 MCP 服务器

特征

先决条件

安装

来自源

使用 npm

用法

启动 MCP 服务器

与 MCP 客户端集成

可用工具

生成图像

快速图像

批量生成图像

输出格式

执照

Tools