金大哥 - fal-mcp-server MCP 详情

article

README

🚀 AI视频生成MCP服务器

本MCP（模型上下文协议）服务器为您提供强大的工具，可借助AI图像生成模型，依据文本提示和/或图像来生成精彩视频。

🚀 快速开始

此MCP服务器能帮助您轻松利用AI图像生成模型，从文本提示和图像生成视频。您可以按照以下步骤开启使用之旅。

✨ 主要特性

多样化生成方式：既可以依据文本提示生成视频，也能使用开始和/或结束图像来生成视频。
精细参数控制：能够灵活控制视频的宽高比、分辨率、时长以及是否循环等参数。
实时状态查看：随时查看视频的生成状态。
多模型选择：支持选择不同的AI模型进行视频生成。

📦 安装指南

克隆仓库：将此仓库克隆到本地。
安装依赖项：
```
npm install
```
设置API密钥：创建.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 --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许可证。

fal-mcp-server