🚀 FLUX图像生成器MCP服务器
FLUX图像生成器MCP服务器可借助Black Forest Lab的FLUX模型生成图像，采用了最新的MCP SDK（v1.7.0），能为用户提供便捷的图像生成服务。
🚀 快速开始
FLUX图像生成器MCP服务器是一个用于图像生成的工具，借助Black Forest Lab的FLUX模型，可根据文本提示生成高质量图像。以下是使用该服务器的基本步骤：
- 完成安装（具体安装方法见“📦 安装指南”）。
- 启动服务器（具体启动命令见“💻 使用示例”）。
- 调用可用工具生成图像（具体工具使用方法见“💻 使用示例”）。
✨ 主要特性
- 文本生成图像：根据输入的文本提示，生成相应的图像。
- 自定义设置：支持自定义图像维度、提示上采样和安全设置，满足多样化需求。
- 本地保存：可将生成的图像保存到本地。
- 批量生成：支持从多个提示批量生成图像，提高效率。
📦 安装指南
从源码安装
- 克隆此仓库。
- 安装依赖：
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 |
内容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 密钥。服务器支持多种自定义设置，可根据用户需求生成不同维度、不同细节程度的图像。同时，支持批量生成图像，提高了图像生成的效率。