🚀 AI视频生成MCP服务器
本MCP（模型上下文协议）服务器为您提供强大的工具，可借助AI图像生成模型，依据文本提示和/或图像来生成精彩视频。
🚀 快速开始
此MCP服务器能帮助您轻松利用AI图像生成模型，从文本提示和图像生成视频。您可以按照以下步骤开启使用之旅。
✨ 主要特性
- 多样化生成方式：既可以依据文本提示生成视频，也能使用开始和/或结束图像来生成视频。
- 精细参数控制：能够灵活控制视频的宽高比、分辨率、时长以及是否循环等参数。
- 实时状态查看：随时查看视频的生成状态。
- 多模型选择：支持选择不同的AI模型进行视频生成。
📦 安装指南
- 克隆仓库：将此仓库克隆到本地。
- 安装依赖项：
npm install - 设置API密钥：创建
.env文件，并设置FAL.AI API密钥。
API密钥可从FAL.AI获取。FAL_KEY=your_fal_key_here
🔧 服务器操作
服务器构建
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 --prompt "在太空中漂浮的巨大城市" --resolution 1080p --duration 60
# 使用开始和结束图像生成视频
generate-video --image_url "start_frame.png" --end_image_url "end_frame.png" --fps 24 --duration 30
📚 详细文档
可用工具
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
模型比较
| 属性 | 详情 |
|---|---|
| 支持的模型 | Luma Ray2 Flash - Luma的先进图片转视频模型；Kling v1.6 Pro - Kling的高质量图片转视频模型 |
| 支持的输入类型 | 两个模型均支持图片和文本输入 |
| 输出视频质量 | 两个模型输出的视频质量都较高 |
| 处理速度 | Luma Ray2 Flash处理速度快，Kling v1.6 Pro处理速度中等 |
| 最大分辨率 | Luma Ray2 Flash最大分辨率为4k，Kling v1.6 Pro最大分辨率为1080p |
| 支持的时长 | Luma Ray2 Flash支持长时长（超过60秒），Kling v1.6 Pro支持较短时长（不超过30秒） |
⚠️ 注意事项
⚠️ 重要提示
- 两个模型均使用FAL.AI的信用，费用可能不同。
- 高分辨率和长时间视频消耗更多信用。
- 确保API密钥有效且正确设置。
🛠️ 故障排除
API密钥错误
检查环境变量FAL_KEY是否正确设置。您也可以在Claude Desktop设置文件中直接配置。
视频生成失败
如果出现视频生成错误，请检查详细错误信息并：
- 确保API密钥有效。
- 检查账户是否有足够信用。
- 避免使用不适当提示或图像。
- 重试前等待片刻。
📄 许可证
本项目采用MIT许可证。