RunningHub Canvas Bridge

让 AI 通过 MCP 操作 RunningHub 无限画布。

发现画布 · 配置应用 · 绑定素材 · 提交生成 · 下载结果

开始安装 · Agent 接入 · 工具目录 · 下载发布包

从对话到画布

把重复的开页、填参数、连参考、整理和下载交给 AI。桥接复用浏览器中已登录的 RunningHub 会话，让支持 MCP 的客户端直接操作画布，减少逐步点击和截图识别。

支持国际站 www.runninghub.ai / rhtv.runninghub.ai；保留中国站地址适配。可使用 Codex 内置浏览器、Chrome 或 Edge，通过本机 stdio MCP 接入，也可通过 Secure MCP Tunnel 接入 ChatGPT 个人插件。

内置浏览器也能接入

安装专用扩展后，不需要外部 Chrome 提供画布连接。打开画布和账号目录请求优先使用在线的内置浏览器，也可明确指定浏览器来源。仍需本机桥接服务运行。

多个对话，各自操作自己的画布

默认场次分组纵向、镜头每行四列，按真实横竖画幅预留空间，避免预览后重叠。明确淘汰节点可经依赖检查和快照备份后清理；应用配置会清理空的未使用输入。

每个任务持有独立 scopeId；自动开页会固定到具体页面。其他对话选择另一张画布，不会改变当前任务的目标。页面刷新或连接失效后重新打开获取连接，同一画布的写入仍需遵守版本检查。

原生 AI 应用与普通模型都可配置

直接读取原生应用的输入字段，修改时长、比例、种子等参数，绑定图片、视频、音频或文本参考。应用节点使用专用预检和运行路径，不再要求普通模型节点的 modelCode。

下载不依赖归档软件

按节点或准确的历史任务下载结果，查看进度、校验文件、重试失败任务；服务器支持且存在校验标识时可续传。光栈（Lumen）自动归档为可选集成。

媒体处理与费用授权

截帧、图片裁剪/缩放/旋转可在浏览器内免费处理；视频剪裁、倍速、倒放与音频提取也可使用桥接电脑的 FFmpeg。Agent 会比较画布与本地能力的便利性和效果再选择路径，原素材保留。

涉及积分或费用未确认的原生视频处理、AI 重绘/扩图/超分/修复，先生成具体计划，经用户授权后执行一次。授权绑定输入和参数，超时不会自动重复提交。付费原生路径已经接入授权流程，但尚未进行真实扣费验收；详细用法见 Agent 指南。

Related MCP server: rh-agent-bridge

快速开始

准备： Node.js 22+、ffmpeg/ffprobe，以及一个已登录 RunningHub 的受支持浏览器。

git clone https://github.com/limyum-creator/runninghub-canvas-bridge.git
cd runninghub-canvas-bridge
npm ci
npm run build
npm run release:package
npm start

然后加载浏览器扩展：

在浏览器扩展管理器选择“加载未打包的扩展程序”。内置浏览器的入口是 设置 → 浏览器 → 扩展程序管理器 → 管理。下载 ZIP 时先解压，再选择包含 manifest.json 的目录。

将 server/mcp.mjs 配置为客户端的 stdio MCP 入口，即可开始。完整配置、Windows 命令、后台服务与 ChatGPT 插件接入见 安装说明。 默认启动不启用生成；需要生成时按安装说明设置 RH_BRIDGE_ALLOW_GENERATION=1。

自动更新

正式安装包可开启自动更新：node scripts/rh-update.mjs enable。Windows / macOS 每六小时检查正式 Release，空闲时更新桥接、MCP、页面运行时和已登记扩展；保留配置与 OAuth 授权，失败回退程序。源码开发目录不会被覆盖。

首次装入本版后需重新加载一次旧扩展，后续已登记扩展可自行检测更新并重载。客户端可能需要刷新工具列表；普通更新不需要重新授权账号。详见 自动更新与恢复。

一次典型调用

rh_list_canvases               查询账号目录
        ↓
rh_open_canvas                静默复用目标连接，取得独立 scopeId
        ↓
rh_get_layout_template        读取持久排版规范
        ↓
rh_canvas_summary / get_node  检查已有内容
        ↓
配置节点 → 绑定素材 → preflight → run_node
        ↓
查询任务 → 下载结果 → 可选归档

后续画布调用都携带自己的 scopeId。需要修改时打开连接须设置 allowWrites: true；生成使用独立的稳定 requestId。超时先查询原回执，不盲目重发。

能力与验证边界

实时模型、登录状态、平台接口和账号权益会影响可用性。详见 验证说明。

文档导航

npm run check
npm test
npm run build
npm run release:package
npm pack --pack-destination dist

dist/ 包含普通扩展、内置浏览器专用扩展及校验文件。源码包包含本地运行所需模块。登录凭据留在网页内；私有安装笔记、任务回执和项目素材不应提交到仓库。

参考

本仓库为独立实现。连接 RunningHub 画布的思路，参考了 windzu/runninghub-canvas-bridge。