图像生成服务器

Fal.ai MCP服务器提供与Fal.ai图像生成模型和工作流的无缝集成,支持600多种模型和预构建工作流,适用于创意设计和自动化图像生成场景。

  • by gravicity-archive
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Gravicity/fal-mcp-server

使用说明

Fal.ai MCP服务器

MCP(模型上下文协议)服务器,可与Fal.ai的图像生成模型和工作流无缝集成。

特性

  • 🎨 图像生成 -访问600多种Fal.ai模型,包括Flux、Stable Diffusion等
  • 🔄 工作流支持 -运行预制管道,如sdxl贴纸
  • 🚀 流媒体 -长时间运行操作的实时进度更新
  • 📦 简单API -所有模型和工作流的统一界面
  • ⚡ 队列管理 -内置异步操作状态跟踪

安装

快速安装(npm)

npm install -g fal-mcp-server

来源

git clone https://github.com/yourusername/fal-mcp-server.git
cd fal-mcp-server
npm install
npm run build
npm link

设置

1.获取您的Fal.ai API密钥

注册地址: 对不起的。 并从仪表板获取您的API密钥。

2.添加到克劳德代码

claude mcp add fal --env "FAL_KEY=your-api-key-here" -- npx -y fal-mcp-server

3.验证连接

claude mcp list

您应该看到:

fal: npx -y fal-mcp-server - ✓ Connected

可用工具

generate_image

使用任何Fal.ai模型生成图像。

参数:

  • prompt (必填):图像的文字描述
  • model:型号ID(默认:“fal-ai/flux/schnell”)
  • image_size:“方形”、“园景4_3”或“肖像3_4”
  • num_images:1-4张图片
  • seed:用于可再生发电

例子:

{
  "prompt": "a cyberpunk cat in neon city",
  "model": "fal-ai/flux/dev",
  "image_size": "landscape_4_3",
  "num_images": 2
}

run_model

使用自定义参数运行任何Fal.ai模型。

参数:

  • model_id (必填):模型端点ID
  • input (必填):特定型号的输入参数
  • stream:启用流媒体实时更新

例子:

{
  "model_id": "fal-ai/stable-diffusion-v3-medium",
  "input": {
    "prompt": "professional portrait photo",
    "negative_prompt": "low quality, blurry"
  }
}

run_workflow

执行Fal.ai工作流(多步骤管道)。

参数:

  • workflow_id (必填):工作流ID
  • input (必填):工作流输入参数
  • stream:流式工作流事件

例子:

{
  "workflow_id": "workflows/fal-ai/sdxl-sticker",
  "input": {
    "prompt": "cute puppy mascot"
  }
}

list_popular_models

获取Fal.ai的热门模特列表。

check_status

检查异步请求的状态。

参数:

  • request_id (必填):要检查的请求ID

热门型号

  • 快速/快速/快速 -最快通量模型(4步)
  • fal-ai/flux/dev -高品质Flux型号
  • fal-ai/flux pro -专业Flux型号
  • fal-ai/fast sdxl -快速稳定扩散XL
  • fal-ai/稳定扩散-v3-medium -最新SD3
  • 失败/重新起草-v3 -艺术风格生成

工作流

  • 工作流/fal ai/sdxl贴纸 -生成→ 删除BG→ 贴纸

Claude代码中的用法

安装后,您可以使用自然语言与Fal.ai进行交互:

  • “使用Flux生成赛博朋克城市景观”
  • “制作一个可爱机器人的贴纸”
  • “使用小狗提示运行sdxl贴纸工作流”
  • “列出可用的图像型号”

环境变量

  • FAL_KEY (必需):您的Fal.ai API密钥

发展

# Install dependencies
npm install

# Build TypeScript
npm run build

# Watch mode for development
npm run watch

# Run locally
FAL_KEY=your-key node dist/index.js

许可证

麻省理工学院

贡献

欢迎投稿!请提交PR以改进服务器。

支持