STARWARCLOUD STARWAR.AI
返回市场
视梦-v3-幻-MCP服务器

视梦-v3-幻-MCP服务器

作者：PierrunoYT12 星标更新：2025-09-16
安装使用来源：spider==github.com

项目介绍

SeedDream 4.0 FAL MCP 服务器

这是一个使用字节跳动的SeedDream 4.0模型通过FAL AI平台提供图像生成能力的Model Context Protocol (MCP)服务器。

特性

SeedDream 4.0 是一种新一代的图像创建模型，它将图像生成和图像编辑功能集成到一个统一的架构中：

  • 高级文本到图像生成，具有改进的质量和细节
  • 灵活的图像尺寸，从1024x1024到4096x4096像素
  • 多图像生成，可配置批次大小
  • 增强的安全检查，过滤不适当的内容
  • 统一架构，结合生成和编辑功能
  • 高质量输出，具有卓越的细节和连贯性
  • 快速生成，优化处理

可用工具

generate_image

根据SeedDream 4.0的文本提示生成单个或多个图像。

参数：

  • prompt（必需）：要生成的图像的文字描述
  • image_size（可选）：图像尺寸 - 可以是：
    • 预设：square_1024，square_1280，square_1536，portrait_1024，portrait_1280，landscape_1024，landscape_1280，wide_1024，tall_1024
    • 自定义：{width: number, height: number}（1024-4096像素范围）
    • 默认值：square_1280（1280x1280）
  • num_images（可选）：独立生成的数量（1-6，默认值：1）
  • max_images（可选）：每次生成的最大图像数量（1-6，默认值：1）
  • seed（可选）：用于可重复结果的随机种子
  • sync_mode（可选）：在响应前等待上传（默认值：false）
  • enable_safety_checker（可选）：启用内容过滤（默认值：true）

generate_image_batch

在一个请求中生成具有不同提示的多个图像。

参数：

  • prompts（必需）：文本提示数组（1-5个提示）
  • image_size（可选）：所有图像的尺寸（预设或自定义，默认值：square_1280）
  • enable_safety_checker（可选）：启用安全检查（默认值：true）

安装

先决条件

  1. FAL AI API密钥：从FAL AI获取您的API密钥

  2. Node.js：确保安装了Node.js（版本16或更高）

快速设置（推荐）

使用npx是最简单的方式，它可以自动下载并运行最新版本：

对于Claude桌面应用

将服务器添加到您的Claude桌面配置文件中：

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

{
  "mcpServers": {
    "seedream4": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/PierrunoYT/seedream-v4-fal-mcp-server.git"
      ],
      "env": {
        "FAL_KEY": "your-fal-api-key-here"
      }
    }
  }
}

对于Kilo Code MCP设置

添加到您的MCP设置文件中： C:\Users\[username]\AppData\Roaming\Code\User\globalStorage\kilocode.kilo-code\settings\mcp_settings.json

{
  "mcpServers": {
    "seedream4": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/PierrunoYT/seedream-v4-fal-mcp-server.git"
      ],
      "env": {
        "FAL_KEY": "your-fal-api-key-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

npx配置的好处

✅ 通用访问：适用于任何安装了Node.js的机器 ✅ 无需本地安装：npx会自动下载和运行 ✅ 始终最新版本：从GitHub仓库拉取 ✅ 跨平台：兼容Windows、macOS、Linux ✅ 设置同步：在您使用的任何MCP客户端上都有效

手动安装（替代方案）

如果您更喜欢本地安装：

  1. 克隆仓库

    git clone https://github.com/PierrunoYT/seedream-v4-fal-mcp-server.git
cd seedream-v4-fal-mcp-server

  2. 安装依赖项

    npm install

  3. 构建服务器

    npm run build

  4. 在配置中使用绝对路径

    {
  "mcpServers": {
    "seedream4": {
      "command": "node",
      "args": ["/absolute/path/to/seedream-v4-fal-mcp-server/build/index.js"],
      "env": {
        "FAL_KEY": "your-fal-api-key-here"
      }
    }
  }
}

辅助脚本以获取绝对路径：

npm run get-path

使用示例

一旦配置完成，您可以通过您的MCP客户端使用该服务器：

基本图像生成

生成一幅日落时分的未来城市景观图，带有飞行汽车

自定义图像尺寸

创建一幅宽广的风景图像（1600x1280），描绘宁静的山湖

多图像生成

生成3种不同的可爱机器人角色变体（num_images: 3）

高分辨率生成

创建一幅详细的人物肖像（1536x1536分辨率），描绘一位智慧的老巫师

批量生成

为这些提示生成图像："早晨露水中的红玫瑰"，"蓝色海洋波浪"，"绿色森林小径"

带有自定义参数

生成一幅方形图像（1280x1280），描绘魔法森林，启用安全检查器，并使用种子12345

同步模式即时访问

创建一幅太空站图像，并启用sync_mode以实现即时下载

图像尺寸预设

SeedDream 4.0 支持以下预设尺寸：

  • 正方形格式：

    • square_1024：1024x1024
    • square_1280：1280x1280（默认）
    • square_1536：1536x1536

  • 竖版格式：

    • portrait_1024：1024x1280
    • portrait_1280：1280x1600

  • 横版格式：

    • landscape_1024：1280x1024
    • landscape_1280：1600x1280

  • 特殊格式：

    • wide_1024：1536x1024
    • tall_1024：1024x1536

您还可以指定自定义尺寸{width: number, height: number}，其中两个值都在1024到4096像素之间。

API响应格式

服务器返回关于生成图像的详细信息：

成功使用SeedDream 4.0生成了1幅图像：

提示："日落时分的未来城市景观"
图像尺寸：1280x1280
图像数量：1
每批最大图像数：1
安全检查器：已启用
使用的种子：1234567890

生成的图像：
图像1（1280x1280）：
  本地路径：./images/seedream4_futuristic_cityscape_1234567890_1_2024-01-01T12-00-00-000Z.png
  原始URL：https://storage.googleapis.com/falserverless/...

开发

本地测试

# 直接测试服务器
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node build/index.js

监视模式

npm run watch

检查工具

npm run inspector

故障排除

常见问题

  1. "FAL_KEY环境变量未设置"

    • 服务器将继续运行并显示这条有用的错误消息
    • 确保您的FAL API密钥正确设置在MCP配置中
    • 验证密钥有效且有足够的信用额度
    • 注意：当缺少API密钥时，服务器不再崩溃

  2. "服务器在Claude中不可见"

    • 如果使用npx配置，请确保安装了Node.js
    • 对于手动安装，请检查绝对路径是否正确
    • 配置更改后重启Claude Desktop
    • 验证JSON配置语法是否有效

  3. "生成失败"

    • 检查您的FAL AI账户是否有足够的信用额度
    • 验证您的API密钥具有必要的权限
    • 尝试使用一个简单的提示来测试连接
    • 确保图像尺寸在1024-4096范围内

  4. "无效图像尺寸"

    • 使用有效的预设或确保自定义尺寸在1024-4096范围内
    • 检查自定义尺寸是否同时指定了宽度和高度

  5. "找不到npx命令"

    • 确保Node.js安装正确
    • 尝试运行node --version和npm --version以验证安装

服务器稳定性改进

✅ 健壮的错误处理：即使没有API令牌，服务器也会继续运行 ✅ 优雅的关闭：正确处理SIGINT和SIGTERM信号 ✅ 用户友好的消息：清晰的错误消息附带设置说明 ✅ 不再崩溃：消除了导致连接中断的process.exit()调用 ✅ 增强的验证：对所有参数进行全面的输入验证

调试日志

服务器将调试信息输出到stderr，这有助于诊断问题：

  • 生成进度更新
  • 带有有用说明的错误消息
  • API调用详情
  • 图像下载状态
  • 优雅关闭通知

SeedDream 4.0的新特性

相比SeedDream 3.0的改进

  • 统一架构：在一个模型中结合生成和编辑功能
  • 增强质量：改进的图像细节和连贯性
  • 灵活的尺寸：支持高达4096像素的自定义尺寸
  • 多图像生成：更好的批量生成控制
  • 高级安全性：增强的内容过滤功能
  • 更好的性能：优化的生成流水线

从SeedDream 3.0迁移

如果您正在升级到SeedDream 4.0：

  1. API端点：现在使用fal-ai/bytedance/seedream/v4/text-to-image
  2. 纵横比：被灵活的image_size参数取代
  3. 新参数：增加了max_images，sync_mode，enable_safety_checker
  4. 尺寸限制：从2K扩展到4K最大分辨率
  5. 预设：新的方便的尺寸预设适用于常见用例

定价

图像生成费用由FAL AI的定价结构决定。查看FAL AI定价以获取当前费率。

许可

该项目根据MIT许可发布 - 查看LICENSE文件以获取详细信息。

贡献

  1. 分叉仓库
  2. 创建功能分支
  3. 进行更改
  4. 如适用，添加测试
  5. 提交合并请求

支持

对于以下相关的问题：

  • 此MCP服务器：在此仓库中打开一个问题
  • FAL AI API：联系FAL AI支持
  • SeedDream 4.0模型：参考FAL AI文档

更新日志

v0.2.0（最新 - SeedDream 4.0）

  • 🚀 升级至SeedDream 4.0：新的统一架构用于生成和编辑
  • 📐 灵活的图像尺寸：支持高达4096x4096的自定义尺寸
  • 🎯 增强的预设：9个方便的尺寸预设适用于常见用例
  • 🔒 高级安全性：改进的内容过滤，具有可配置的安全检查器
  • ⚡ 多图像生成：通过num_images和max_images获得更好的控制
  • 🔄 同步模式：选项以即时访问图像，而无需CDN延迟
  • 🛡️ 增强的验证：对所有参数进行全面的输入验证
  • 📊 更好的响应：更多详细的生成信息和状态

v0.1.1（SeedDream 3.0）

  • 🔧 解决连接中断：移除导致服务器崩溃的process.exit()调用
  • 🛡️ 改进的错误处理：即使没有API令牌，服务器也会继续运行
  • 🌍 增加了便携性：npx配置适用于任何机器
  • 📦 增强的稳定性：优雅的关闭处理器和空值安全检查
  • 💬 更好的用户体验：清晰的错误消息附带设置说明
  • 🔄 自动更新：npx自动从GitHub拉取最新版本

v0.1.0（SeedDream 3.0）

  • 初始发布，支持SeedDream 3.0
  • 支持单个和批量图像生成
  • 双语提示支持（英语/中文）
  • 多种纵横比
  • 可配置的生成参数