MCP

FlowReel Agent 画布接口

FlowReel MCP 可以让 Codex、Claude Desktop、Cursor 等 Agent 直接读取、创建、修改和保存 Pro 画布。 普通用户只需要描述“我想做什么视频”,Agent 就可以调用工具搭建出节点画布。

查看 Manifest给 Agent 读取打开画布

接入方式

在 MCP 客户端里添加一个 stdio server。把路径换成你本机仓库的绝对路径,账号密码换成自己的 FlowReel 登录信息。

{
  "mcpServers": {
    "flowreel": {
      "command": "node",
      "args": ["/absolute/path/to/video-maker/mcp/server.mjs"],
      "env": {
        "FLOWREEL_BASE_URL": "https://wovenverse.online",
        "FLOWREEL_EMAIL": "you@example.com",
        "FLOWREEL_PASSWORD": "your-password"
      }
    }
  }
}

也可以用已有登录态 Cookie:设置 FLOWREEL_COOKIE=session=...。 不要把密码或 Cookie 写入 Git 仓库。

Agent 使用规则

先用 canvas_list_projects 找项目,或者用 canvas_create_project 新建空白画布。

用户只给一句需求时,优先调用 canvas_build_from_brief 自动搭建基础画布。

需要精细控制时,读取 canvas_get_graph,再用 canvas_add_nodecanvas_connect_nodes 修改。

只有用户明确要求生成/执行时,才能调用 canvas_run_graph,因为它可能消耗积分。

工具列表

flowreel_login登录 FlowReel,通常由环境变量自动完成。
canvas_list_projects列出当前用户的画布和项目。
canvas_create_project创建空白 Pro 画布。
canvas_get_graph读取指定项目的 CreationGraph。
canvas_save_graph完整保存 CreationGraph。
canvas_add_node向画布添加文本、图片、视频、合成等节点。
canvas_connect_nodes连接两个节点,并补齐常用输入输出端口。
canvas_build_from_brief根据一句话需求自动搭建基础画布。
canvas_run_graph执行画布,可能消耗积分。

CreationGraph 节点类型

input.text

文本/脚本/需求输入

input.image

图片素材输入

input.video

视频素材输入

input.audio

音频素材输入

gen.t2i

文生图

gen.t2v

文生视频

gen.i2v

图生/参考视频

gen.tts

文本转语音

gen.smart_canvas

智能画布方案

gen.stage3d

3D 导演台

compose

视频/音频合成

output

最终产物

最小画布示例

{
  "nodes": [
    {
      "id": "n_text",
      "kind": "input.text",
      "position": { "x": 80, "y": 120 },
      "params": { "text": "一条高级感香水广告,夜景,9:16" },
      "result": {}
    },
    {
      "id": "n_video",
      "kind": "gen.t2v",
      "position": { "x": 420, "y": 120 },
      "params": {
        "prompt": "一条高级感香水广告,夜景,9:16",
        "ratio": "9:16",
        "durationSec": 5,
        "resolution": "480p"
      },
      "result": {}
    }
  ],
  "edges": [
    {
      "id": "e_text_video",
      "source": "n_text",
      "target": "n_video",
      "sourceHandle": "text",
      "targetHandle": "prompt"
    }
  ],
  "consistency": { "ratio": "9:16" }
}