MCP Server

RooYun MCP Server：让 Claude Code、Cursor 直接做 AI 漫剧

RooYun MCP Server 是 RooYun 官方的远程 MCP（Model Context Protocol）服务。在 Claude Code、Cursor 等 AI 工具里填一个地址和一枚 API 令牌，AI 就能替你建项目、把剧本拆成角色和分镜、搭好画布、先报价再提交图片与视频生成，产物落在你网页里看到的同一张画布上。

服务地址
https://www.rooyun.com/api/mcp
传输方式
Streamable HTTP（远程服务，不用装本地程序）
鉴权
请求头 Authorization: Bearer <API 令牌>
工具数量
34 个
官方登记
MCP Registry · com.rooyun/rooyun
查看分步接入创建 API 令牌
1

创建 API 令牌

登录后到个人中心「API 访问」创建令牌（以 dj_pat_ 开头），可以按需勾选权限、设消费限额。装了 RooYun Skill 的话，让 AI 运行 dj login，在弹出的网页点一次「授权」即可，不用复制令牌。

2

在 AI 工具里添加服务

把下面的 dj_pat_你的令牌 换成你自己的令牌。

Claude Code：一行命令

sh
claude mcp add --transport http rooyun https://www.rooyun.com/api/mcp --header "Authorization: Bearer dj_pat_你的令牌"

Cursor：写进 ~/.cursor/mcp.json

json
{
  "mcpServers": {
    "rooyun": {
      "type": "http",
      "url": "https://www.rooyun.com/api/mcp",
      "headers": {
        "Authorization": "Bearer dj_pat_你的令牌"
      }
    }
  }
}

其他 MCP 客户端（Cline、WorkBuddy 等）

传输方式选 Streamable HTTP（有的客户端叫 HTTP），地址填 https://www.rooyun.com/api/mcp，再加一个请求头 Authorization: Bearer dj_pat_你的令牌。 不支持 MCP 的工具（如 Codex）可以调同一套 REST API，见 Agent 接入。

3

让 AI 开工

直接说想做什么，例如「用 RooYun 把这段剧本做成第 1 集的分镜画布，先报价再生成」。AI 会先调 whoami 确认令牌权限，再按建项目 → 拆剧本 → 搭画布 → 报价 → 生成的顺序做。

Tools

提供的 34 个工具

按一集的制作顺序排列。右侧是该工具需要的令牌权限；标「扣积分」的工具才会花钱。

账号与项目确认令牌、建项目和画布

  • whoami令牌自省任何令牌
  • list_projects列出项目读项目
  • create_project新建项目（含首画布）写画布
  • create_canvas在项目下新建附加画布写画布
  • list_canvases列出项目下的全部画布读项目

剧本分析把剧本拆成角色、场景、道具和分镜，改写文案

  • extract_from_script剧本 → 角色 / 场景 / 道具扣积分剧本分析
  • make_storyboard剧本 → 分镜表扣积分剧本分析
  • rewrite_text改写 / 优化 / 翻译 / 写词扣积分剧本分析

搭画布读写画布上的卡片和连线，给角色定音色

  • read_canvas读画布结构读项目
  • read_node详读单张卡片读项目
  • apply_canvas_ops批量执行画布操作写画布
  • get_character_voices读角色定嗓（谁还没定音色）读项目
  • set_character_voice给一个角色定嗓 / 解绑写画布

多轮创作会话和平台的创作助手多轮改稿

  • create_conversation开一段多轮 Agent 会话剧本分析
  • list_conversations列出多轮会话（恢复现场）剧本分析
  • read_conversation读一段会话（元信息 + 计费口径 + 历史）剧本分析
  • send_message发一轮（会花用户的积分）扣积分剧本分析
  • delete_conversation删掉一段会话（硬删，不可撤销）剧本分析

模型与素材目录查可用模型、音色、数字人，反推素材提示词

  • list_models模型目录与单价任何令牌
  • list_voices音色目录任何令牌
  • list_digital_humans专属数字人目录（仅管理员）任何令牌
  • caption_asset图片 / 视频反推提示词扣积分剧本分析

体检、报价与生成生成前检查画布、先报价，确认后再提交

  • lint_canvas画布体检（出片前的门禁）读项目
  • estimate_generation_cost生成预检报价提交生成
  • start_generation提交生成任务扣积分提交生成
  • list_generations列生成任务（恢复现场）读任务
  • get_generation查询生成任务读任务
  • cancel_generation取消生成任务提交生成

质检、局部重绘与取件检查分镜图、让用户涂选重绘区域、下载产物、查余额

  • inspect_image分镜图质检剧本分析
  • create_edit_session签发免登录编辑链接（交给用户涂）写画布
  • get_edit_session查编辑链接的状态写画布
  • list_assets列出产物资产读素材
  • get_asset_download_url取产物下载地址读素材
  • get_wallet查询账户余额读余额

Pricing

怎么收费

  • 接入 MCP Server 本身免费，没有订阅费；读项目、搭画布、体检、报价都不扣积分。
  • 只有 6 个工具会扣积分：extract_from_script、make_storyboard、rewrite_text、send_message、caption_asset、start_generation。价格和网页端相同，1 积分 = 1 元，图片按张、视频按秒计费，生成失败退回积分。
  • 提交生成前必须先调 estimate_generation_cost 报价，AI 把合计积分给你看、你确认后才提交。
  • 每枚令牌可以设消费限额，用完后新的生成会被拒绝；不想让 AI 花钱，创建令牌时不勾「提交生成」「剧本分析」权限。

各模型单价见 计费说明，生成前的报价以系统实时价目为准。

Open source

官方登记与开源仓库

服务已发布到官方 MCP Registry，名称 com.rooyun/rooyun。 配套的 Skill（教 AI 按「剧本 → 角色 / 场景 → 分镜 → 生成」的顺序做漫剧）与 Claude Code 插件开源在 DeepHiveAI/rooyun-skill。

MCP Registry 条目Skill 与插件（GitHub）Gitee 镜像

常见问题

RooYun MCP Server 是什么？

它是 RooYun 官方的远程 MCP（Model Context Protocol）服务。Claude Code、Cursor 等支持 MCP 的 AI 工具接上它之后，可以直接在 RooYun 里建项目、拆剧本、搭分镜画布、报价并提交图片和视频生成，产物落在你网页里看到的同一张画布上。

需要安装什么吗？

不需要安装本地程序。它是远程服务，在 AI 工具里填一个地址和一枚 API 令牌即可。想让 AI 按固定流程做漫剧，可以再装一份 Skill（可选）。

接入 MCP 要花钱吗？

连接和大部分工具不花钱：读项目、搭画布、体检、报价都不扣积分。只有提交生成、剧本分析、改写、会话每一轮和素材反推会扣积分，价格和网页端相同（1 积分 = 1 元），生成前先报价，你确认后才提交，失败退回积分。

AI 会不会擅自花掉我的积分？

工具说明会让 AI 先调 estimate_generation_cost 报价、你确认后再提交生成（这是写给 AI 的约定，服务端不强制）。要硬性兜底，可以给令牌设消费限额，额度用完新的生成会被拒绝；不想让它花钱，创建令牌时不勾「提交生成」和「剧本分析」权限即可。

支持哪些 AI 工具？

支持 Streamable HTTP 传输的 MCP 客户端都可以，例如 Claude Code、Cursor、Cline、WorkBuddy。不支持 MCP 的工具可以调同一套 REST API。

在哪里能找到这个服务的官方登记？

它已发布到官方 MCP Registry，名称 com.rooyun/rooyun；Skill 与 Claude Code 插件开源在 GitHub DeepHiveAI/rooyun-skill。