MCP Fal Ai Image

🚀 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 密钥无缝集成。
• 本地保存：将图像本地保存并提供可访问的文件路径。
• 简单配置与强大错误处理：具备简单配置和强大的错误处理能力。

📦 安装指南

1. 确保您已经安装了 Node.js 18+。
2. 获取 fal.ai API Key。
3. 按照上述“快速开始”中的步骤进行配置和运行。

💻 使用示例

示例提示

• 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