项目简介

SeedDream 4.0 FAL AI MCP 服务是一个基于Model Context Protocol (MCP) 构建的后端服务,旨在为大语言模型(LLM)客户端提供强大的图像生成功能。它通过集成Bytedance的SeedDream 4.0图像模型和FAL AI平台,允许LLM用户通过简单的文本指令生成高质量的图像,并支持高级定制。

主要功能点

  • 高级文本到图像生成: 使用SeedDream 4.0模型,通过文本描述生成细节丰富、质量卓越的图像。
  • 灵活的图像尺寸: 支持从1024x1024到4096x4096像素的多种预设尺寸或自定义尺寸。
  • 多图像批量生成: 可一次性生成多张图像或针对多个提示词进行批量生成。
  • 增强的安全检查: 内置内容过滤功能,确保生成的图像内容符合规范。
  • 统一的生成与编辑架构: 利用SeedDream 4.0的统一架构,为未来的图像编辑功能预留可能性。

安装步骤

  1. 获取FAL AI API Key:
    • 访问 FAL AI 注册账户并获取您的API密钥。
    • 请妥善保管此密钥,后续配置时需要用到。
  2. 安装Node.js:
    • 确保您的系统已安装Node.js (版本16或更高)。您可以通过在命令行运行 'node -v' 来检查。

服务器配置 (供MCP客户端使用)

MCP客户端(如Claude Desktop App或Kilo Code)需要配置以下信息才能连接此服务器。以下是配置的关键要素:

  • 名称 (server name): 'seedream4' (这是一个示例名称,您可以根据需要自定义)
  • 启动命令 (command):
    • 通过 'npx' 运行 (推荐): 'npx'
    • 手动安装后运行: 'node'
  • 启动参数 (args):
    • 通过 'npx' 运行:
      • '-y' (自动确认下载)
      • 'https://github.com/PierrunoYT/seedream-v4-fal-mcp-server.git' (指定GitHub仓库URL)
    • 手动安装后运行:
      • '/absolute/path/to/seedream-v4-fal-mcp-server/build/index.js' (这是服务器构建后的入口文件路径。您可以在仓库目录下运行 'npm run get-path' 命令获取准确的绝对路径。)
  • 环境变量 (env):
    • 必须设置 'FAL_KEY' 环境变量,其值为您在第一步获取的FAL AI API密钥。例如: '"FAL_KEY": "您的FAL_AI_API_密钥"'

配置示例 (JSON格式说明,请根据您的MCP客户端的配置方式手动添加):

推荐的 'npx' 配置方式:

{
  "mcpServers": {
    "seedream4": {
      "command": "npx",
      "args": ["-y", "https://github.com/PierrunoYT/seedream-v4-fal-mcp-server.git"],
      "env": {
        "FAL_KEY": "您的FAL_AI_API_密钥" 
      }
    }
  }
}

手动安装后的配置方式:

{
  "mcpServers": {
    "seedream4": {
      "command": "node",
      "args": ["/absolute/path/to/seedream-v4-fal-mcp-server/build/index.js"], 
      "env": {
        "FAL_KEY": "您的FAL_AI_API_密钥" 
      }
    }
  }
}

请注意:

  • 上述JSON仅为示例结构,您需要将其整合到您的MCP客户端的实际配置文件中。
  • 请务必将 '"您的FAL_AI_API_密钥"' 替换为您的真实FAL AI API密钥。
  • 手动安装方式中,'/absolute/path/to/seedream-v4-fal-mcp-server/build/index.js' 需要替换为您的本地实际路径。

基本使用方法

配置完成后,您可以在支持MCP的LLM客户端中直接通过自然语言指令调用图像生成功能,例如:

  • 基本图像生成: 'Generate an image of a futuristic cityscape at sunset with flying cars' (生成一张未来城市日落景观图,带飞车)
  • 自定义图像尺寸: 'Create a wide landscape image (1600x1280) of a serene mountain lake' (生成一张1600x1280的宁静山湖宽幅风景图)
  • 生成多张图像: 'Generate 3 variations of a cute robot character (num_images: 3)' (生成3个可爱机器人角色的变体)
  • 高分辨率生成: 'Create a detailed portrait in 1536x1536 resolution of a wise old wizard' (生成一张1536x1536分辨率的睿智老法师肖像)
  • 批量生成 (多个提示词): 'Generate images for these prompts: "a red rose in morning dew", "a blue ocean wave", "a green forest path"' (为这些提示词生成图像: "清晨露珠红玫瑰", "蓝色海浪", "绿色森林小径")
  • 带参数生成: 'Generate a square image (1280x1280) of a magical forest with safety checker enabled and seed 12345' (生成一张1280x1280的魔法森林方图,启用安全检查,使用种子12345)

信息

分类

AI与计算