FLUX 图像生成器 MCP 服务器
一个 MCP(模型上下文协议)服务器,用于使用 Black Forest Lab 的 FLUX 模型生成图像。使用最新的 MCP SDK (v1.7.0)。
特征
- 根据文本提示生成图像
- 自定义图像尺寸、快速上采样和安全设置
- 将生成的图像保存在本地
- 从多个提示批量生成图像
先决条件
安装
来自源
- 克隆此存储库
- 安装依赖项:
- 根据
.env.example
创建一个.env
文件并添加您的 Black Forest Lab API 密钥:
BFL_API_KEY=your_api_key_here
- 构建项目:
使用 npm
npm install -g @modelcontextprotocol/server-flux-image-generator
用法
启动 MCP 服务器
使用以下命令启动服务器:
对于使用自动重新编译的开发:
与 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"
}
]
}
执照
麻省理工学院