Runway ML

@mindstone/mcp-server-runway

适用于 Model Context Protocol 主机的 Runway ML MCP 服务。借助 Runway 的生成式 AI 模型，通过标准化的 MCP 接口生成 AI 视频、图像、音频、语音和音效，并管理自定义语音。

状态

• 版本： 0.4.1 · npm
• 身份验证： API 密钥（RUNWAYML_API_SECRET）
• 工具： 23（视频、图像、音频、语音、任务）
• 接口类型： cloud-api
• 机器可读： STATUS.json

要求

• Node.js 20+
• npm

一键安装

点击按钮后，主机将提示你填写：RUNWAYML_API_SECRET、RUNWAY_REQUEST_TIMEOUT_MS、RUNWAY_UPLOAD_TIMEOUT_MS。

{
  "mcpServers": {
    "Runway ML": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-runway"
      ],
      "env": {
        "RUNWAYML_API_SECRET": "",
        "RUNWAY_REQUEST_TIMEOUT_MS": "60000",
        "RUNWAY_UPLOAD_TIMEOUT_MS": "600000"
      }
    }
  }
}

快速开始

安装与构建

cd <path-to-repo>/connectors/runway
npm install
npm run build

npx（发布后使用）

npx -y @mindstone/mcp-server-runway

本地

node dist/index.js

配置

环境变量

• RUNWAYML_API_SECRET — Runway API 密钥（从 dev.runwayml.com 获取）
• MCP_HOST_BRIDGE_STATE — 可选的主机桥接状态文件路径，用于凭据管理
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE 的向后兼容别名
• RUNWAY_REQUEST_TIMEOUT_MS — 可选的覆盖值（正整数毫秒，最长 30 分钟），用于设置应用于 Runway JSON API 和主机桥接调用的出站 HTTP 请求超时。默认值：60000（60 秒）。如果缓慢提交时出现 TIMEOUT 错误，请调高此值；如果希望限制更严格，请调低此值。
• RUNWAY_UPLOAD_TIMEOUT_MS — 可选的覆盖值（正整数毫秒，最长 30 分钟），用于设置 uploadEphemeral 的签名 URL 上传阶段超时（上传大型本地文件）。默认值：600000（10 分钟）。该值适用于典型消费级上行网络（约 5 Mbps）下最高 200MB 的上传，并预留了充足余量；网络较慢时请调高此值，或在需要更严格的限制时调低此值。

主机配置示例

Claude Desktop / Cursor

{
  "mcpServers": {
    "Runway": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-runway"],
      "env": {
        "RUNWAYML_API_SECRET": "your-api-key"
      }
    }
  }
}

本地开发（无需发布到 npm）

{
  "mcpServers": {
    "Runway": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/runway/dist/index.js"],
      "env": {
        "RUNWAYML_API_SECRET": "your-api-key"
      }
    }
  }
}

工具（23 个）

配置

• configure_runway_api_key — 保存你的 Runway API 密钥

视频

• generate_video_from_image — 将静态图像制作成动画视频
• generate_video_from_text — 根据文本描述创建视频
• generate_video_from_video — 为现有视频重新设计风格或进行转换（Aleph 2.0）
• character_performance — 为角色制作动画，加入面部表情和身体动作（Act-Two）
• upscale_video — 将视频提升至 4K（Magnific Video Upscaler）

图像

• generate_image — 根据文本生成图像，还可选择使用参考图像

音频

• generate_speech — 使用 ElevenLabs 音色根据文本生成语音
• generate_sound_effect — 根据文本描述生成音效
• swap_voice — 替换音频或视频文件中的声音
• dub_audio — 将音频翻译并配音成另一种语言
• isolate_voice — 从背景音频中分离人声

音色

• list_custom_voices — 列出你创建的所有自定义音色
• create_custom_voice — 根据文本描述创建自定义音色
• preview_voice — 生成音色的简短音频预览
• delete_custom_voice — 删除自定义音色

任务管理

• check_runway_task — 检查生成任务的状态
• wait_for_runway_task — 等待任务完成（自动轮询）
• cancel_runway_task — 取消或删除任务
• download_runway_output — 将 Runway 输出下载到本地文件
• upload_media — 将本地文件上传到 Runway 的临时存储空间

账户

• get_runway_balance — 查看点数余额、等级限制和用量
• query_credit_usage — 按模型和日期查询详细点数用量

许可协议

FSL-1.1-MIT — 功能源码许可证，1.1 版，未来将采用 MIT 许可证。该软件将于 2030-04-08 转为 MIT 许可证。