dreamina-mcp
v1.0.0
Published
MCP server for Dreamina (Seedance 2.5): batch video generation from Claude Code and Claude Desktop through the SeedFlow Chrome extension. The missing Dreamina API — prompts, queue, references, first/last frames, edits, auto-download on your own Dreamina p
Maintainers
Readme
SeedFlow MCP — 即梦 (Dreamina) 批量视频生成,由 Claude 驱动
即梦 (Dreamina) 的网页版套餐没有公开 API。 这个 MCP 服务器让 Claude Code 和 Claude Desktop 能够在即梦内部进行操作:在您已付费的即梦套餐上,批量生成 Seedance 2.5 视频,支持多达 7 个带角色的参考图、首尾帧、4-30 秒时间线、视频到视频编辑(编辑、延长、放大、插帧、配乐)以及自动下载。无需按秒计费的 API 账单,也无需 API 密钥。

您,在 Claude 中: “为这个瓶子制作一个 30 秒的竖版广告,照片在
D:/bottle,结尾加上标志。” Claude,通过 SeedFlow:dream_status→dream_generate(包含 4 个阶段的时间线,@Image 1= 产品)→dream_wait✓ 视频片段已保存到seedflow-out/BottleAd/
工作原理
Claude Code / Claude Desktop
│ MCP (stdio, JSON-RPC)
▼
dreamina-mcp ── local bridge on 127.0.0.1:8788 ── files → seedflow-out/
▲ HTTP, polled every few seconds
│
SeedFlow Chrome extension ──► Dreamina tab (dreamina.capcut.com)MCP 服务器(即本仓库)纯粹是传输层:包含五个工具和一个本地 HTTP 网桥,零依赖。SeedFlow Chrome 扩展程序在 Dreamina 标签页中完成实际工作——它输入提示词,设置模型/宽高比/时长/分辨率,附加参考图和帧,等待渲染并下载带有清晰编号名称的视频片段。连接后,扩展程序会将其导演手册(Seedance 2.5 提示词公式、50 种电影制作技巧、参考图角色、积分价格、场景链式连接)交给网桥;dream_status 会将其传递给 Claude,因此 Claude 的行为就像一位导演,而不是一个打字员。
快速开始
1. 安装扩展程序 — SeedFlow — Dreamina & Claude MCP 的 Seedance 自动化(Chrome 网上应用店列表正在审核中;产品页面有当前的安装链接)。前 24 小时免费,无需密钥和银行卡。
2. 添加 MCP 服务器。
Claude Code:
claude mcp add seedflow -- npx -y dreamina-mcpWindows: 如果 PowerShell 拒绝运行
claude.ps1/npm.ps1(脚本执行策略),请改用.cmd垫片:claude.cmd mcp add seedflow -- npx.cmd -y dreamina-mcp。
没有 npm?同一个服务器可以直接从 GitHub 运行:
npx -y github:DanikVR/dreamina-seedance-mcp。
Claude Desktop — 添加到 claude_desktop_config.json:
{
"mcpServers": {
"seedflow": { "command": "npx", "args": ["-y", "dreamina-mcp"] }
}
}3. 打开 Dreamina,访问 dreamina.capcut.com/ai-tool/home?type=video 并登录。当网桥连接成功时,Chrome 工具栏中的扩展程序图标会显示 Claude ✓。
4. 与 Claude 对话。 它会提出两到三个简短问题(目标、平台、素材),在时间线上提出场景,告知所需的积分成本,然后开始生成:
Make a 30-second ad for a thermal mug, vertical. Photos are in D:/mug. Logo at the end.视频片段会保存在 Claude 启动位置旁边的 seedflow-out/<folder>/ 目录中(可通过 OF_OUT 覆盖;如果该目录不可写,网桥将回退到 ~/seedflow-out)。
工具
| 工具 | 功能 |
|---|---|
| dream_status | 扩展程序是否连接,是否有 Dreamina 视频标签页打开,队列中有哪些内容 — 以及 Claude 遵循的导演手册 extension.director。请首先调用此工具。 |
| dream_generate | 排队生成一个或多个视频片段:提示词、模型(Seedance 2.5 / 2.0 Mini 草稿)、宽高比、时长 4-30 秒、分辨率、变体、最多 7 个带角色的参考图、首尾帧、链式连接、预期积分消耗、试运行。立即返回 jobId。 |
| dream_wait | 等待作业完成并返回文件路径。每 5 秒轮询一次,最长可达 timeoutSec。 |
| dream_edit | 对已完成的视频片段进行视频到视频编辑:按描述编辑、延长、创意放大、60 fps 插帧、生成配乐、重新生成。 |
| dream_cancel | 取消所有尚未开始渲染的任务。 |
完整参数参考:docs/tools.md。该网桥还在 127.0.0.1:8788 上公开了一个纯 HTTP API(/health、/jobs、/jobs/:id、/cancel),供非 MCP 客户端的脚本使用。
Seedance 2.5 提示词公式(导演手册教给 Claude 的内容)
每次生成时长为 4-30 秒。提示词是一个时间线,而不是一个句子:
[Generation Goal] one line: what the clip is.
[Reference roles] @Image 1 defines the hero's face. @Image 2 defines the product. Do not use @Image 3 for style.
[0-5s] … one camera move with an end state …
[5-12s] … next beat …
{Name says in English, calm: 8–15 words} ← spoken lines, 11 languages
【On-screen text in the user's language】
Audio: sounds of visible actions. NO BGM. No subtitles.宽高比、时长和分辨率是生成参数,绝不是提示词文本。在 Seedance 2.0 Mini 上进行 5 秒的草稿生成,最终在 Seedance 2.5 上完成。扩展程序提供的 50 种一键式电影制作技巧(推拉镜头、冲击变焦、360° 环绕、子弹时间、第一人称视角、产品英雄旋转、匹配剪辑、快速摇摄、标志结局等)正是针对这些节拍预先编写的公式。
Claude 技能
skills/ 目录中包含两个 Claude Code 技能,它们能将 Claude 变成 Dreamina 导演:
- seedance-director — 当用户想要视频时始终启用:包含 5 步对话、Seedance 2.5 事实和积分信息、提示词公式、节拍 → 技巧映射、50 种技巧目录、编辑规则(锁定后修改)以及三个音轨层。
- ad-video — 一行简要说明 → 故事板 → 参考图角色 → 英文提示词 →
dream_generate/dream_wait。
将它们复制到您项目的 .claude/skills/ 目录中(或 ~/.claude/skills/ 中,适用于所有项目)。技能主体目前是俄语;Claude 可以正常读取,英语版本正在规划中。
扩展程序新增功能
10 个组别中的 50 种一键式电影制作技巧,带角色的参考图(主角、产品、背景、风格),首尾帧和场景链式连接,确保主角在不同视频片段中保持一致,三个音轨层,每次运行前的积分计算器,一个手动工作室面板和内置聊天助手(适用于不使用 Claude 的用户)—— 此外,还为 Dreamina 不支持的语言(俄语、阿拉伯语、印地语)提供了翻译界面。详细信息、截图和定价:lingoflow.pro/seedflow。
安全性
- 网桥仅监听
127.0.0.1。要从其他机器(Tailscale 等)访问它,请设置OF_HOST和OF_PORT;然后每个请求都必须携带~/.seedflow-token中的令牌(x-seedflow-token请求头)。 - 只有
chrome-extension://来源可以调用网桥;其他任何来源都将收到 403 错误。 - 除了扩展程序本身发送到 Dreamina 的内容外,没有任何数据会离开您的机器。提示词和视频片段都保留在本地磁盘上。扩展程序仅与 lingoflow.pro 通信以验证其许可证密钥。
- 扩展程序会模拟您的操作,并在每次运行之间暂停。使用您自己的账户和套餐:没有验证码绕过,没有私有 API,没有多账户操作,也没有水印去除。
系统要求
- Node.js 20 或更新版本。
- Chrome 116+ 并安装 SeedFlow 扩展程序。
- 拥有积分的 Dreamina 账户(Seedance 2.5 访问权限)。
- Claude Code 或 Claude Desktop。
常见问题
没有扩展程序也能工作吗? 不能。MCP 服务器是传输层;视频生成是通过扩展程序在您的 Dreamina 标签页内完成的。
扩展程序是免费的吗? 安装后的前 24 小时免费,无需密钥。之后,使用银行卡可免费使用一周,然后是年度或一次性许可证。定价信息可在产品页面查看。
为什么不使用 Seedance API? API 按视频秒数计费;Dreamina 套餐按积分计费,相同视频片段的成本会便宜数倍,而且大多数 Dreamina 用户已经拥有该套餐。对比信息可在产品页面查看。
我可以在一台机器上运行网桥,在另一台机器上运行 Claude 吗? 可以 — 在安装 Chrome 的机器上运行 OF_HOST=0.0.0.0 OF_PORT=8788 npx -y dreamina-mcp,然后将扩展程序的网桥 URL(扩展程序设置中)指向它并传递令牌。
文件会保存到哪里? 当前工作目录下的 seedflow-out/,或者由 OF_OUT=/path 指定。
链接
- 产品页面和定价:lingoflow.pro/seedflow
- 问题、支持、想法:t.me/GuruAppSheet
- Google Flow (Veo 3 / Omni 1.1) 的姊妹项目:OmniFlow MCP · lingoflow.pro/omniflow
English: README.md · Русская версия: README.ru.md
来源与致谢
扩展程序和技能中的提示词公式及技巧均提炼自官方 Seedance 2.5 指南、公开的 Dreamina 提示词指南和开放社区仓库,并经过实际生成验证。如果您认出自己的作品并希望在此处获得署名,请提出 issue — 我们会添加。
许可证
MIT © DanikVR。SeedFlow Chrome 扩展程序是独立的授权产品。
