使用说明
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(必填):模型端点IDinput(必填):特定型号的输入参数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(必填):工作流IDinput(必填):工作流输入参数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以改进服务器。