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