MCP 服务器

FLUX Image Generator MCP Server

一个 MCP 服务器，它使用黑森林实验室 (Black Forest Lab) 的 FLUX 模型，根据文本提示生成图像，并允许自定义图像尺寸、提示词放大 (upsampling)、安全设置和批量生成。

Tools

generateImage

Generate an image using Black Forest Lab's FLUX model based on a text prompt

quickImage

Quickly generate an image based on a text prompt with default settings

batchGenerateImages

Generate multiple images from a list of prompts

README

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 获取)

安装

从源码安装

克隆此仓库
安装依赖项:

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

可用工具

generateImage

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

参数:

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

示例:

{
  "prompt": "日落时分宁静的湖泊，背景是群山",
  "width": 1024,
  "height": 768,
  "promptUpsampling": true,
  "seed": 12345,
  "safetyTolerance": 3
}

quickImage

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

参数:

prompt (字符串, 必需): 要生成的图像的文本描述

示例:

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

batchGenerateImages

从提示语列表中生成多个图像。

参数:

prompts (字符串数组, 必需): 文本提示语列表 (最多 10 个)
width (数字, 可选, 默认: 1024): 图像的宽度
height (数字, 可选, 默认: 1024): 图像的高度

示例:

{
  "prompts": [
    "日落时分宁静的湖泊",
    "一个未来城市景观",
    "一个拥有发光植物的魔法森林"
  ],
  "width": 1024,
  "height": 768
}

输出格式

所有工具都以以下格式返回响应:

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

对于错误:

{
  "error": true,
  "message": "错误描述"
}

批量工具返回:

{
  "total": 3,
  "successful": 2,
  "failed": 1,
  "results": [
    {
      "prompt": "日落时分宁静的湖泊",
      "success": true,
      "image_url": "https://storage.example.com/image1.jpg",
      "local_path": "/path/to/output/flux_batch_1234567890_0.png"
    },
    {
      "prompt": "一个未来城市景观",
      "success": true,
      "image_url": "https://storage.example.com/image2.jpg",
      "local_path": "/path/to/output/flux_batch_1234567890_1.png"
    },
    {
      "prompt": "禁止内容",
      "success": false,
      "error": "内容策略违规"
    }
  ]
}