MCP fal.AI Image Server

MCP fal.ai图像服务器

使用以下命令从文本提示轻松生成图像 对不起的。 以及模型上下文协议（MCP）。直接与Cursor和Windsurf等AI IDE集成。

何时以及为什么使用

此工具设计用于：

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

主要特点：

• 支持任何有效的fal.ai模型和所有主要图像参数。
• 使用Node.js和fal.ai API密钥即可开箱即用。
• 使用可访问的文件路径在本地保存图像。
• 配置简单，错误处理能力强。

快速开始

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

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

1. 运行： 使用 generate-image IDE中的工具。

💡 典型工作流程： 描述你想要的图像（例如，“使用fal-ai/kolors模型生成一个有飞行汽车的景观，2张图像，landscape_16_9”），并在你的IDE中获得即时结果。

🗨️ 示例提示

• 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/型号.

故障排除

• FAL_KEY environment variable is not set：如上所述设置您的fal.ai API密钥。
• npx 找不到：安装Node.js 18+和npm。

Advanced: Example MCP Request/Response

{
  "tool": "generate-image",
  "args": {
    "prompt": "A futuristic cityscape at sunset",
    "model": "fal-ai/kolors"
  }
}

// Example response
{
  "images": [
    { "url": "file:///path/to/generated_image1.png" },
    { "url": "file:///path/to/generated_image2.png" }
  ]
}

📁 图像输出目录

生成的图像将保存到本地系统：

• 默认情况下： ~/Downloads/fal_ai （在Linux/macOS上；如果可用，则使用XDG标准）
• 自定义位置： 设置环境变量 FAL_IMAGES_OUTPUT_DIR 到您想要的文件夹。图像将保存在 /fal_ai.

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

⚠️ 错误处理和故障排除

• 如果您指定了fal.ai不支持的模型ID，您将收到来自后端的错误。仔细检查拼写错误或访问 fal.ai/型号 以确认型号ID。
• 有关型号及其功能的最新列表，请参阅 fal.ai型号目录 或 API文件.
• 对于其他错误，请查阅您的MCP客户端日志或在GitHub上打开问题。

🤝 贡献

欢迎提出意见和建议！请打开问题或拉取请求 .

🔒 安全

• 您的API密钥仅用于本地验证fal.ai。
• 除fal.ai API要求外，不存储或传输用户数据。

🔗 链接

• 对不起的。

🛡 许可证

麻省理工学院许可证©2025 Madhusudan Kulkarni