mcp-fal-ai-image

🚀 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 apple
• generate an image of a red apple using model fal-ai/kolors
• generate 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_<timestamp>.png。

错误处理

常见错误

1. API Key 验证失败

Error: Authentication failed with fal.ai API

解决方法：

• 检查 FAL_KEY 是否正确设置。
• 确保 API Key 未过期。

2. 网络连接问题

Error: Failed to connect to fal.ai server

解决方法：

• 检查互联网连接。
• 确保 https://api.fal.ai 可访问。

3. 无效的输入参数

Error: Invalid input parameters

解决方法：

• 检查提示词或模型 ID 是否正确格式化。

报告错误

• 如果遇到其他问题，请在 GitHub 提交 issue。
• 提供以下信息以帮助调试：
  • 错误日志
  • 输入参数（如果可能，匿名化 API Key）
  • 操作系统和 Node.js 版本

贡献指南

• 欢迎提交问题、功能请求和拉取请求！
• 查看 CONTRIBUTING.md 了解更多信息。

安全性

• 您的 API Key 仅用于本地身份验证与 fal.ai。
• 除非 fal.ai API 要求，否则不会存储或传输任何用户数据。

链接

• NPM
• GitHub
• fal.ai

📄 许可证

MIT License © 2025 Madhusudan Kulkarni