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