AI 视频生成器 MCP 服务器

该 MCP（模型上下文协议）服务器提供使用 AI 图像生成模型从文本提示和图像生成视频的工具。

兼容型号

Luma Ray2 Flash - Luma 的尖端图像到视频转换模型
Kling v1.6 Pro - Kling 的高质量图像到视频转换模型

功能

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

安装

克隆此存储库
安装依赖项：
npm install
创建一个.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"
      }
    }
  }
}

可用工具

生成视频

它使用人工智能模型根据文本提示和/或图像生成视频。

参数：

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）

检查视频状态

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

参数：

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 密钥无效或已过期
您的账户余额不足
不适当的提示或图像
暂时的服务器端问题

如果错误仍然存在，请等待一段时间并重试或尝试更改提示。

执照

麻省理工学院