AI Video Generator MCP Server

AI视频生成器MCP服务器

这个MCP（Model Context Protocol）服务器AI提供使用图像生成模型从文本提示或图像生成动画的工具。

支持的模型

• Luma Ray2闪光灯 - Luma的最尖端图像→动画转换模型
• 克林v1.6专业版 - Kling的高品质图像→动画转换模型

机能

• 通过文本提示生成视频
• 使用开始和/或结束图像生成动画
• 运动图像参数控制（纵横比、分辨率、长度、循环）
• 检查生成状态
• 使用，使用AI选择模型

安装

1. 克隆此存储库
2. 安装依赖关系：

   npm install

1. .env创建文件，然后单击FAL.AI API设置关键帧：

   FAL_KEY=your_fal_key_here

API关键点是FAL。人工智能求值时使用曲面法线的原始方向

构建服务器

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"
      }
    }
  }
}

可用工具

生成视频

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”，“3:4”，“21:9”，“9:21”）
• resolution （默认“540p”）：视频分辨率（“540p”、“720p”、“1080p”）
• duration （默认“5s”）：视频长度（“5s”，“9s”）
• loop （默认值false): 是否循环视频
• model （默认“luma”）：使用AI模型（“luma”=Ray2，“kling”=Kling v1.6Pro）

检查视频状态

确认动画生成请求的状态。

参数：

• request_id （必需）：要检查的请求ID
• model （默认“luma”）：用于请求AI模型（“luma”=Ray2，“kling”=Kling v1.6Pro）

Claude使用示例

猫が毛糸玉で遊んでいる動画を生成してください。縦向きモードでお願いします。Klingモデルを使用してください。

Claude是适当的参数generate-video调用工具，查看结果视频URL中描述的相应参数的值。

模型比较

• Luma Ray2闪光灯：具有良好的平滑运动和逼真的物理行为，可获得自然结果。
• 克林v1.6专业版：具有良好的详细质感和特殊效果，可获得样式化的结果。

根据提示和所需结果，最佳模型可能有所不同。

制限事项

• 视频生成可能需要很长时间（特别是高分辨率）
• 已启用FAL.AI API你需要钥匙和足够的信用
• 高分辨率或长视频会消耗更多的信贷
• 两个型号FAL.AI的信用（费用可能因型号而异）

故障排除

API键错误

FAL_KEY请确保已正确设置环境变量。Claude Desktop也可以在设定文件中直接设定。

视频生成错误

如果视频生成过程中出现错误，则会记录详细的错误消息。常见问题包括：

• API密钥无效或过期
• 帐户信用不足
• 不正确的提示或图像
• 服务器端的临时问题

如果错误仍然存在，请稍候再试或更改提示。

许可证

麻省理工学院