
RunwayML + Luma AI MCP Server

2025.04.02
3
TypeScript视频生成图像生成内容创作内容生成
mcp-video-gen 是一个基于 RunwayML 和 Luma AI API 的 MCP 服务器,专注于视频和图像生成任务。它提供了多种工具来生成视频、图像,并支持对生成内容的管理和增强。
View on GitHub
Overview
基本能力
产品定位
mcp-video-gen 是一个专门用于视频和图像生成的 MCP 服务器,通过集成 RunwayML 和 Luma AI 的 API,提供强大的内容生成能力。
核心功能
- 从文本提示生成视频(支持 RunwayML 或 Luma AI)
- 从图像生成视频(支持 RunwayML 或 Luma AI)
- 从文本提示生成图像(Luma AI)
- 管理 Luma AI 生成内容(列表、获取、删除)
- 为 Luma AI 生成内容添加音频
- 提升 Luma AI 生成内容的分辨率
- 使用 OpenRouter LLMs 增强生成前的提示
适用场景
- 音乐视频片段创作
- 产品广告概念设计
- 图像动画制作
- 内容创作者快速生成视觉素材
- 营销人员制作宣传视频
工具列表
generate_text_to_video
: 从文本生成视频generate_image_to_video
: 从图像生成视频enhance_prompt
: 使用 OpenRouter 优化提示luma_generate_image
: 使用 Luma AI 生成图像luma_list_generations
: 列出 Luma AI 生成内容luma_get_generation
: 获取特定 Luma AI 生成内容详情luma_delete_generation
: 删除特定 Luma AI 生成内容luma_get_camera_motions
: 列出支持的相机运动luma_add_audio
: 为 Luma 生成内容添加音频luma_upscale
: 提升 Luma 生成内容的分辨率
常见问题解答
- 如何获取 API 密钥?
-
需要分别从 RunwayML、Luma AI 和 OpenRouter 获取 API 密钥
-
生成任务需要多长时间?
-
生成时间取决于任务复杂度和 API 提供商,通常在几分钟到十几分钟不等
-
如何处理大文件?
- 服务器支持通过 URL 引用大文件,避免直接上传
使用教程
使用依赖
- Node.js (v18 LTS 或更高版本)
- npm (通常随 Node.js 一起安装)
- API 密钥:
- RunwayML API Secret
- Luma AI API Key
- OpenRouter API Key (用于
enhance_prompt
工具)
安装教程
- 克隆或下载: 获取服务器代码
- 导航到目录: 在服务器根目录打开终端
- 安装依赖:
bash npm install
- 配置环境变量:
- 创建
.env
文件 - 添加 API 密钥:
dotenv RUNWAYML_API_SECRET=your_runwayml_api_secret_here LUMAAI_API_KEY=your_luma_api_key_here OPENROUTER_API_KEY=your_openrouter_api_key_here
运行服务器
- 构建服务器:
bash npm run build
- 启动服务器:
bash npm start
调试方式
- 检查服务器状态:
- 查看终端输出是否显示
RunwayML MCP server running on stdio
- 测试工具调用:
- 使用 MCP 客户端调用简单工具如
luma_get_camera_motions
测试连接 - 查看日志:
- 服务器运行时的错误和警告信息会输出到终端
示例工作流程
1. 音乐视频片段(赛博朋克风格)
- 使用
luma_generate_image
生成基础图像 - 使用
generate_image_to_video
为图像添加动画
2. 产品广告概念(悬浮耳机)
- 使用
luma_generate_image
生成产品场景 - 使用
generate_image_to_video
为场景添加动画
3. 图像动画(RunwayML Gen3a)
- (可选)使用
luma_generate_image
生成基础图像 - 使用
generate_image_to_video
为图像添加动画
许可证
None