AI视频生成 MCP 服务器

此MCP（模型上下文协议）服务器提供使用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
   

   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

使用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

示例

# 从文本提示生成视频
generate-video --prompt "在太空中漂浮的巨大城市" --resolution 1080p --duration 60

# 使用开始和结束图像生成视频
generate-video --image_url "start_frame.png" --end_image_url "end_frame.png" --fps 24 --duration 30

模型比较

注意事项

• 两个模型均使用FAL.AI的信用，费用可能不同
• 高分辨率和长时间视频消耗更多信用
• 确保API密钥有效且正确设置

故障排除

API密钥错误

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

视频生成失败

如果出现视频生成错误，请检查详细错误信息并：

1. 确保API密钥有效
2. 检查账户是否有足够信用
3. 避免使用不适当提示或图像
4. 重试前等待片刻

许可证

MIT