npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

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

Readme

SeedFlow MCP — 即梦 (Dreamina) 批量视频生成,由 Claude 驱动

Product page npm npm downloads License: MIT

即梦 (Dreamina) 的网页版套餐没有公开 API。 这个 MCP 服务器让 Claude Code 和 Claude Desktop 能够在即梦内部进行操作:在您已付费的即梦套餐上,批量生成 Seedance 2.5 视频,支持多达 7 个带角色的参考图、首尾帧、4-30 秒时间线、视频到视频编辑(编辑、延长、放大、插帧、配乐)以及自动下载。无需按秒计费的 API 账单,也无需 API 密钥。

SeedFlow — batch Seedance 2.5 generation in Dreamina, driven from Claude

您,在 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-mcp

Windows: 如果 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 指定。

链接

English: README.md · Русская версия: README.ru.md

来源与致谢

扩展程序和技能中的提示词公式及技巧均提炼自官方 Seedance 2.5 指南、公开的 Dreamina 提示词指南和开放社区仓库,并经过实际生成验证。如果您认出自己的作品并希望在此处获得署名,请提出 issue — 我们会添加。

许可证

MIT © DanikVR。SeedFlow Chrome 扩展程序是独立的授权产品。