@visionengine/render

VisionEngine Remotion Render MCP Server — 通过远端渲染 Worker 渲染视频、静帧图片、音频和图片序列。

Tools

| Tool | Description | |------|-------------| | submit | 异步提交渲染任务，返回 taskId。支持视频（MP4）、静帧（still）、音频、图片序列等多种导出类型。 | | query | 根据 taskId 查询渲染任务状态（queued, bundling, rendering, encoding, done, failed）及进度信息。 | | list | 列出当前用户最近的渲染任务，按创建时间倒序排列。 |

环境变量

| 变量 | 必填 | 默认值 | 说明 | |----------|----------|---------|-------------| | API_KEY | 是 | | 用户 API Key，用于身份认证 | | RENDER_WORKER_URL | 否 | https://veconline-ai-render.visionengine-tech.com | 渲染 Worker 服务地址 | | RENDER_TIMEOUT_MS | 否 | 60000 (60s) | submit 请求超时（毫秒） |

使用

MCP 配置

{
  "mcpServers": {
    "ve-render": {
      "command": "npx",
      "args": [
        "-y",
        "@visionengine/render@latest"
      ],
      "transport": "stdio",
      "env": {
        "API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

典型调用流程

1. 调用 submit 提交渲染任务，获取 taskId
2. 等待一定时间后，调用 query + taskId 轮询状态
3. 也可用 list 查看最近的渲染任务列表

submit 参数说明

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | compositionId | string | 是 | Remotion 组合 ID（如 'CaptionVideoComposition'） | | inputProps | object | 否 | Remotion 入参，以 JSON 对象形式传递（如脚本、说话人列表、主题等） | | exportType | enum | 否 | 导出类型：video（默认）、still、audio、image-sequence | | codec | enum | 否 | 视频编码：h264（默认）, h265, vp8, vp9, prores, gif（仅 exportType=video 时有效） | | audioCodec | enum | 否 | 音频编码：mp3（默认）, aac, wav（仅 exportType=audio 时有效） | | imageFormat | enum | 否 | 输出格式：png（默认）, jpeg, pdf, webp（仅 exportType=still/image-sequence 时有效） | | outName | string | 否 | 输出文件名或相对路径，不填则自动生成 | | startFrame | number | 否 | 部分渲染的起始帧 | | endFrame | number | 否 | 部分渲染的结束帧 | | everyNthFrame | number | 否 | 每 N 帧渲染一帧（默认 1） | | frame | number | 否 | 指定渲染的帧号（仅 exportType=still 时有效） |

query 参数说明

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | taskId | string | 是 | submit 返回的任务 UUID |

list 参数说明

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | limit | number | 否 | 最大返回任务数（1-100，默认 20） |