MCP Fal Ai Image

🚀 MCP fal.ai 画像サーバー

テキストプロンプトを使って画像を簡単に生成できます。fal.ai とモデルコンテキストプロトコル (MCP) を組み合わせ、Cursor や Windsurf などの AI IDE と直接統合されています。

✨ 主な機能

このツールは以下のユーザーを対象に設計されています：

• IDE を離れることなく、テキストプロンプトから画像を生成したい開発者やデザイナー。
• UI コンセプト、マーケティング素材、または創造的なアイデアの迅速なプロトタイピングを行いたいユーザー。
• ブログ、プレゼンテーション、またはソーシャルメディア用の独特なビジュアルを必要とするコンテンツクリエイター。
• 最新の fal.ai モデルを試す AI 研究者や技術愛好者。
• MCP を通じて画像をプログラムで自動生成する自動化ワークフローを構築したいユーザー。

主な機能は以下の通りです：

• 有効なすべての fal.ai モデルと主要な画像パラメータをサポート。
• Node.js と fal.ai API キーとのシームレスな統合。
• 画像をローカルに保存し、アクセス可能なファイルパスを提供。
• シンプルな設定と強力なエラーハンドリング。

🚀 クイックスタート

1. 前提条件：Node.js 18+、fal.ai API Key
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 生成一个红色苹果」）、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/models を参照してください。

📦 出力ディレクトリ

• デフォルトの出力先：./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