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許可證。