🚀 MCP fal.ai 图像服务器
MCP fal.ai 图像服务器让您能无痛地使用文本提示生成图像。它结合了 fal.ai 和模型上下文协议（MCP），并且可以直接与 AI IDE（如 Cursor 和 Windsurf）集成，为图像生成带来极大便利。
🚀 快速开始
先决条件
需要安装 Node.js 18+，并获取 fal.ai API Key。
配置 MCP
{
"mcpServers": {
"fal-ai-image": {
"command": "npx",
"args": ["-y", "mcp-fal-ai-image"],
"env": {
"FAL_KEY": "YOUR-FAL-AI-API-KEY"
}
}
}
}
运行
从 IDE 使用 generate-image 工具即可开始生成图像。
💡 典型工作流程： 描述您想要的图像（例如，“生成一个红色苹果”，“使用模型 fal-ai/kolors 生成一个红色苹果”），并立即在 IDE 中获得结果。
✨ 主要特性
- 广泛的模型支持：支持任何有效的 fal.ai 模型及所有主要的图像参数。
- 无缝集成：与 Node.js 和 fal.ai API 密钥无缝集成。
- 本地保存：将图像本地保存并提供可访问的文件路径。
- 简单易用：简单配置和强大的错误处理。
📦 安装指南
此工具的安装主要通过配置 MCP 完成，具体配置步骤见上文“快速开始”部分。
💻 使用示例
基础用法
以下是一些示例提示：
generate an image of a red applegenerate an image of a red apple using model fal-ai/kolorsgenerate 3 images of a glowing red apple in a futuristic city using model fal-ai/recraft-v3, square_hd, 40 inference steps, guidance scale 4.0, safety checker on
支持的参数：提示词、模型 ID（任何 fal.ai 模型）、生成图像数量、图像尺寸、推理步骤、指导比例、安全检查器。
图像会保存到本地，文件路径在响应中显示。有关模型 ID，请访问 fal.ai/models。
📚 详细文档
使用场景和理由
此工具专为以下用户设计：
- 开发人员和设计师希望从文本提示生成图像，无需离开 IDE。
- 快速原型设计 UI 概念、营销资产或创意想法。
- 内容创作者需要独特的视觉效果用于博客、演示文稿或社交媒体。
- AI 研究员和技术爱好者试验最新的 fal.ai 模型。
- 自动化工作流程以程序化方式生成图像，通过 MCP。
输出目录
- 默认输出位置：
./generated-images/- 图像按日期和时间存储在子文件夹中。
- 每个图像保存为 PNG 格式，命名为
image_。.png
错误处理
常见错误
- API Key 验证失败
Error: Authentication failed with fal.ai API
解决方法：
- 检查
FAL_KEY是否正确设置。 - 确保 API Key 未过期。
- 网络连接问题
Error: Failed to connect to fal.ai server
解决方法：
- 检查互联网连接。
- 确保
https://api.fal.ai可访问。
- 无效的输入参数
Error: Invalid input parameters
解决方法：
- 检查提示词或模型 ID 是否正确格式化。
报告错误
- 如果遇到其他问题，请在 GitHub 提交 issue。
- 提供以下信息以帮助调试：
- 错误日志
- 输入参数（如果可能，匿名化 API Key）
- 操作系统和 Node.js 版本
贡献指南
- 欢迎提交问题、功能请求和拉取请求！
- 查看 CONTRIBUTING.md 了解更多信息。
安全性
- 您的 API Key 仅用于本地身份验证与 fal.ai。
- 除非 fal.ai API 要求，否则不会存储或传输任何用户数据。
链接
📄 许可证
MIT License © 2025 Madhusudan Kulkarni