AI 视频生成 MCP 服务器

这个MCP（Model Context Protocol）服务器提供了一个工具，使用AI图像生成模型从文本提示或图像生成视频。

支持的模型

• Luma Ray2 Flash - Luma最先进的图像→视频转换模型
• Kling v1.6 Pro - Kling高品质的图像→视频转换模型

功能

• 从文本提示生成视频
• 使用起始和/或结束图像生成视频
• 控制视频参数（宽高比、分辨率、长度、循环）
• 检查生成状态
• 选择使用的AI模型

安装

1. 克隆此仓库
2. 安装依赖项：

   npm install
   

3. 创建.env文件，并设置FAL.AI API密钥：

   FAL_KEY=your_fal_key_here
   

   可以从FAL.AI获取API密钥

构建服务器

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

使用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.6 Pro)

check-video-status

检查视频生成请求的状态。

参数：

• request_id (必需): 要检查的请求ID
• model (默认 "luma"): 请求中使用的AI模型 ("luma"=Ray2, "kling"=Kling v1.6 Pro)

Claude中的使用示例

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

Claude将以适当的参数调用generate-video工具，并提供结果视频的URL。

模型比较

• Luma Ray2 Flash: 在流畅的动作和真实的物理行为方面表现出色，产生自然的结果。
• Kling v1.6 Pro: 在细节质感和特殊效果方面表现出色，产生风格化的结果。

根据提示和期望的结果，可能需要选择不同的最佳模型。

限制

• 视频生成可能需要时间（特别是对于高分辨率）
• 需要有有效的FAL.AI API密钥和足够的信用额度
• 高分辨率或长时间的视频会消耗更多的信用额度
• 两个模型都会消耗FAL.AI的信用额度（费用可能因模型而异）

故障排除

API密钥错误

请确认FAL_KEY环境变量是否正确设置。也可以直接在Claude Desktop配置文件中设置。

视频生成错误

如果在视频生成过程中发生错误，详细的错误消息将被记录在日志中。常见的问题包括：

• API密钥无效或已过期
• 账户信用不足
• 不适当的提示或图片
• 服务器端暂时性问题

如果错误持续存在，请稍后再试，或者尝试更改提示。

许可证

MIT