Fal MCP Server

🚀 AIビデオ生成MCPサーバ

このMCP（モデルコンテキストプロトコル）サーバは、AI画像生成モデルを使用して、テキストプロンプトや画像からビデオを生成するツールを提供します。

✨ 主な機能

• テキストプロンプトからビデオを生成します。
• 開始画像や終了画像を使用してビデオを生成します。
• ビデオのパラメータ（アスペクト比、解像度、長さ、ループ）を制御します。
• 生成状態を確認します。
• 使用するAIモデルを選択します。

📦 インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. .envファイルを作成し、FAL.AI APIキーを設定します。

   FAL_KEY=your_fal_key_here
   

   APIキーはFAL.AIから取得できます。

🔧 サーバのビルド

npm run build

🏃‍♂️ サーバの実行

サーバを直接実行します。

npm start

🤝 Claude Desktopとの統合

Claude Desktopでこのサーバを使用するには、claude_desktop_config.jsonファイルに以下の内容を追加してください。

{
  "mcpServers": {
    "video-generator": {
      "command": "node",
      "args": ["your_install_path/fal-mcp-server/build/index.js"],
      "env": {
        "FAL_KEY": "your_fal_key_here"
      }
    }
  }
}

💻 使用例

基本的な使用法

# テキストプロンプトからビデオを生成する
generate-video --prompt "在太空中漂浮的巨大城市" --resolution 1080p --duration 60

# 開始画像と終了画像を使用してビデオを生成する
generate-video --image_url "start_frame.png" --end_image_url "end_frame.png" --fps 24 --duration 30

📚 ドキュメント

利用可能なツール

generate-video

AIモデルを使用して、テキストプロンプトや画像からビデオを生成します。 パラメータ：

• prompt (必須)：生成するビデオ内容のテキスト記述
• image_url (オプション)：ビデオの開始画像のURL（URLまたはbase64データURI）
• end_image_url (オプション)：ビデオの終了画像のURL（URLまたはbase64データURI）
• aspect_ratio (デフォルト "16:9")：ビデオのアスペクト比 ("16:9", "9:16", "4:3", "2.39:1")
• resolution (デフォルト "720p")：ビデオの解像度 ("720p", "1080p", "4k")
• fps (デフォルト 30)：フレームレート
• duration (オプション)：ビデオの長さ（秒）
• loop (デフォルト false)：ループ再生するかどうか

check-video-status

ビデオの生成状態を確認します。 パラメータ：

• video_id (必須)：確認するビデオのID

サポートされるモデル

モデル比較

⚠️ 注意事項

• 両方のモデルはFAL.AIのクレジットを使用し、費用が異なる場合があります。
• 高解像度や長時間のビデオはより多くのクレジットを消費します。
• APIキーが有効で正しく設定されていることを確認してください。

🛠️ トラブルシューティング

APIキーエラー

環境変数FAL_KEYが正しく設定されていることを確認してください。Claude Desktopの設定ファイルで直接設定することもできます。

ビデオ生成失敗

ビデオ生成エラーが発生した場合は、詳細なエラーメッセージを確認し、以下のことを行ってください。

1. APIキーが有効であることを確認します。
2. アカウントに十分なクレジットがあることを確認します。
3. 不適切なプロンプトや画像の使用を避けます。
4. 再試行する前にしばらく待ちます。

📄 ライセンス

MIT