MCP fal.ai 图像服务器

使用 fal.ai 和模型上下文协议 (MCP)，轻松地从文本提示生成图像。直接集成到如 Cursor 和 Windsurf 这样的 AI 开发环境中。

使用场景与原因

此工具适用于：

• 开发者和设计师希望在不离开 IDE 的情况下从文本提示生成图像。
• 快速原型设计 UI 概念、营销资产或创意想法。
• 内容创作者需要独特的视觉效果用于博客、演示文稿或社交媒体。
• AI 研究人员和实验者尝试最新的 fal.ai 模型。
• 自动化需要通过 MCP 进行程序化图像生成的工作流程。

关键特性：

• 支持任何有效的 fal.ai 模型及所有主要图像参数。
• 无需额外配置即可与 Node.js 和 fal.ai API 密钥一起工作。
• 将图像保存到本地系统，并提供可访问的文件路径。
• 简单的配置和强大的错误处理机制。

快速开始

1. 需求：Node.js 18+，fal.ai API 密钥
2. 配置 MCP：

   {
     "mcpServers": {
       "fal-ai-image": {
         "command": "npx",
         "args": ["-y", "mcp-fal-ai-image"],
         "env": { "FAL_KEY": "YOUR-FAL-AI-API-KEY" }
       }
     }
   }
   

3. 运行：从你的 IDE 中使用 generate-image 工具。

💡 典型工作流： 描述你想要的图像（例如，“使用模型 fal-ai/kolors 生成带有飞行汽车的风景，2 张图片，16:9 风景”），并在 IDE 中立即获得结果。

🗨️ 示例提示

• 生成一张红色苹果的图像
• 使用模型 fal-ai/kolors 生成一张红色苹果的图像
• 使用模型 fal-ai/recraft-v3 在未来城市中生成三张发光的红色苹果图像，方形高清，40 步推理，指导比例 4.0，安全检查开启

支持的参数：提示、模型ID（任何 fal.ai 模型）、图像数量、图像大小、推理步骤、指导比例、安全检查。

图像保存在本地系统；文件路径显示在响应中。对于模型ID，请参阅 fal.ai/models。

故障排除

• FAL_KEY 环境变量未设置：按照上述设置您的 fal.ai API 密钥。
• 找不到 npx：安装 Node.js 18+ 和 npm。

<details> <summary>高级：示例 MCP 请求/响应</summary>

{
  "tool": "generate-image",
  "args": {
    "prompt": "日落时分的未来城市景观",
    "model": "fal-ai/kolors"
  }
}

// 示例响应
{
  "images": [
    { "url": "file:///path/to/generated_image1.png" },
    { "url": "file:///path/to/generated_image2.png" }
  ]
}

</details>

📁 图像输出目录

生成的图像保存在本地系统上：

• 默认位置：~/Downloads/fal_ai（在 Linux/macOS 上；如果可用，则使用 XDG 标准）
• 自定义位置：设置环境变量 FAL_IMAGES_OUTPUT_DIR 到您选择的文件夹。图像将保存在 <your-folder>/fal_ai。

每个图像的完整文件路径包含在工具的响应中。

⚠️ 错误处理与故障排除

• 如果指定的模型ID不受 fal.ai 支持，您将收到后端错误。请检查是否有拼写错误或访问 fal.ai/models 确认模型ID。
• 对于最新的模型及其功能列表，请参考 fal.ai 模型目录 或 API 文档。
• 对于其他错误，请查看您的 MCP 客户端日志或在 GitHub 上打开问题。

🤝 贡献

欢迎贡献和建议！请在 GitHub 上打开问题或拉取请求。

🔒 安全

• 您的 API 密钥仅用于本地身份验证与 fal.ai。
• 除 fal.ai API 所需外，不存储或传输任何用户数据。

🔗 链接

• NPM
• GitHub
• fal.ai

🛡 许可证

MIT 许可证 © 2025 Madhusudan Kulkarni