image-sister

image-sister

基于 BFL Flux 2 Pro 的 MCP 图片生成服务器，提供文生图和图像编辑两大核心功能。

功能特性

• 文生图（text_to_image）：通过文本描述生成高质量AI图片
• 图像编辑（image_editing）：基于输入图片和提示词进行风格转换、对象替换等编辑
• 高质量输出：支持最高4MP分辨率的照片级图片
• 灵活配置：可自定义尺寸、安全级别、随机种子等参数
• 独立工具：两个工具独立使用，接口清晰，参数明确

安装配置

1. 安装依赖

npm install

2. 构建项目

npm run build

3. 配置 MCP

在 Claude Desktop 的配置文件中添加服务器配置：

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "image-sister": {
      "command": "npx",
      "args": ["-y", "image-sister"],
      "env": {
        "BFL_API_KEY": "你的BFL_API_KEY"
      }
    }
  }
}

或者使用本地路径（开发模式）：

{
  "mcpServers": {
    "image-sister": {
      "command": "node",
      "args": ["C:\\Users\\DELL\\Desktop\\image-sister\\dist\\index.js"],
      "env": {
        "BFL_API_KEY": "46f3b7d4-32ad-41f4-aba0-3bd6430550de"
      }
    }
  }
}

4. 获取 API Key

访问 BFL Dashboard 注册并获取 API Key。

使用方法

工具1：text_to_image（文生图）

根据文本描述生成AI图片。

参数说明

参数名	类型	必填	默认值	说明
prompt	string	✓	-	图片描述提示词，详细描述想要生成的图片内容、风格、色彩、构图等
width	number	✗	1024	图片宽度，必须是16的倍数
height	number	✗	1024	图片高度，必须是16的倍数
safety_tolerance	number	✗	2	安全容忍度（0-5），值越高限制越少
seed	number	✗	-	随机种子，用于生成可复现的结果

示例

请生成一只可爱的猫咪坐在窗台上看外面的图片

生成一幅赛博朋克风格的未来城市，霓虹灯闪烁，下着雨，夜景

工具2：image_editing（图像编辑）

基于输入图片和文本提示生成新图片，支持风格转换、对象替换、场景修改等。

参数说明

参数名	类型	必填	默认值	说明
prompt	string	✓	-	编辑指令提示词，描述如何修改输入图片
input_image	string	✓	-	输入图片URL，需要编辑的原始图片地址
width	number	✗	1024	输出图片宽度，必须是16的倍数
height	number	✗	1024	输出图片高度，必须是16的倍数
safety_tolerance	number	✗	2	安全容忍度（0-5），值越高限制越少
seed	number	✗	-	随机种子，用于生成可复现的结果

示例

将这张图片 https://example.com/photo.jpg 转换成赛博朋克风格

把图片 https://example.com/cat.jpg 中的猫咪替换成一只小狗

开发

# 开发模式（watch模式）
npm run dev

# 构建
npm run build

技术栈

• TypeScript
• @modelcontextprotocol/sdk
• BFL Flux 2 Pro API

License

MIT