RunwayML + Luma AI MCP Server

RunwayML + Luma AI MCP Server

site icon
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 生成内容的分辨率

常见问题解答

  1. 如何获取 API 密钥?
  2. 需要分别从 RunwayML、Luma AI 和 OpenRouter 获取 API 密钥

  3. 生成任务需要多长时间?

  4. 生成时间取决于任务复杂度和 API 提供商,通常在几分钟到十几分钟不等

  5. 如何处理大文件?

  6. 服务器支持通过 URL 引用大文件,避免直接上传

使用教程

使用依赖

  • Node.js (v18 LTS 或更高版本)
  • npm (通常随 Node.js 一起安装)
  • API 密钥:
  • RunwayML API Secret
  • Luma AI API Key
  • OpenRouter API Key (用于 enhance_prompt 工具)

安装教程

  1. 克隆或下载: 获取服务器代码
  2. 导航到目录: 在服务器根目录打开终端
  3. 安装依赖: bash npm install
  4. 配置环境变量:
  5. 创建 .env 文件
  6. 添加 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

运行服务器

  1. 构建服务器: bash npm run build
  2. 启动服务器: bash npm start

调试方式

  1. 检查服务器状态:
  2. 查看终端输出是否显示 RunwayML MCP server running on stdio
  3. 测试工具调用:
  4. 使用 MCP 客户端调用简单工具如 luma_get_camera_motions 测试连接
  5. 查看日志:
  6. 服务器运行时的错误和警告信息会输出到终端

示例工作流程

1. 音乐视频片段(赛博朋克风格)

  1. 使用 luma_generate_image 生成基础图像
  2. 使用 generate_image_to_video 为图像添加动画

2. 产品广告概念(悬浮耳机)

  1. 使用 luma_generate_image 生成产品场景
  2. 使用 generate_image_to_video 为场景添加动画

3. 图像动画(RunwayML Gen3a)

  1. (可选)使用 luma_generate_image 生成基础图像
  2. 使用 generate_image_to_video 为图像添加动画

许可证

None