Modisign

Modisign MCP

通过 Claude、ChatGPT、Cursor 或任何 MCP 助手制作动态叠加效果并编辑短视频。所有内容都在你的电脑上渲染。

网站 · 叠加效果

你可以提出的要求

• “制作一个红色的订阅按钮，适用于 9:16，并将其保存为绿幕 MP4。”
• “在 ~/Movies/intro.mp4 的 0:03 处加上带有我名字的下三分之一字幕。”
• “把这三段片段剪成一条 Reel，删掉停顿并添加字幕。”
• “把 reference.mp4 放在上层并静音，把 me.mp4 放在下层，两侧各裁掉 5%，让它们同时开始，清理我说话内容的字幕。”
• “用 grind.mp4、pour.mp4、stir.mp4、steam.mp4 和 serve.mp4 制作一个五帧的快速片头，然后按源时间戳和标签“研磨咖啡豆”“倒水”“搅拌”“打奶泡”和“上桌”重放这些片段，格式为 9:16。”
• “在第一个片段中，从源视频 0 秒处的 100% 平滑缩放到 2 秒处的 120%，然后到 3 秒时向左平移 15%；让“看这里”在片段最初半秒内淡入，格式为 9:16。”
• “在 1.2 秒处添加轻微的界面点击声，并在标题“我的三个技巧”出现时添加气泡破裂声；保持片段中的说话音量不变。”
• “在交叉淡化处添加轻微的呼啸声，在指定的叠加效果点击处添加点击声，使用不同变体；告诉我哪些叠加效果没有点击提示音。”
• “给我看看适合美食频道的钩子标题叠加效果。”
• “渲染带透明背景的倒计时叠加效果。”

分屏示例

使用绝对本地路径，将以下内容传给 edit_video：

{
  "clips": [
    {"path":"/absolute/me.mp4","track":"v1","in":0,"out":6,"place":{"mode":"bottom"},"crop":{"top":0,"right":5,"bottom":0,"left":5}},
    {"path":"/absolute/reference.mp4","track":"v2","start":0,"in":0,"out":6,"place":{"mode":"top"},"crop":{"top":0,"right":5,"bottom":0,"left":5},"mute":true}
  ],
  "aspect": "9x16",
  "captions": {"style":"clean","position":"lower","size":"m"}
}

每个片段都需要 track。V1 按列表顺序播放；V2 需要以时间线秒数表示的 start，且不能与其他 V2 片段重叠。裁剪会移除源视频边缘指定比例的内容；省略 crop/place 即表示不裁剪并显示完整画面。字幕和停顿检测仅使用 V1。移除停顿时，两条轨道会一起剪切；重试前请先移除任何与之冲突的 V1 转场。请手动对齐起始位置；此功能不会校正录制偏移。根据下方的叠加效果／字幕规则，1080p 和 720p 均可免费使用，两条轨道总时长最多 180 秒。

快速片头和标题示例

快速片头先以 5–7 个预告剪辑开场，每个剪辑三到六帧（默认五帧），然后重放未更改的片段，并在每段片段上叠加一个标签和时间戳。你需要自行提供描述，或者告诉助手每段片段展示了什么：Modisign 不会查看图片。纯文本标题免费，并保留在你的电脑上。上面的提示词对应一次 edit_video 调用：

{
  "clips": [
    {"path":"/absolute/grind.mp4","track":"v1","in":5,"out":9},
    {"path":"/absolute/pour.mp4","track":"v1","in":65,"out":69},
    {"path":"/absolute/stir.mp4","track":"v1","in":12,"out":16},
    {"path":"/absolute/steam.mp4","track":"v1","in":0,"out":4},
    {"path":"/absolute/serve.mp4","track":"v1","in":125,"out":129}
  ],
  "rapid_intro": {
    "clips": [0, 1, 2, 3, 4],
    "frames_per_clip": 5,
    "timestamp": "source",
    "labels": [
      {"clip":0,"text":"Grind beans"}, {"clip":1,"text":"Pour water"}, {"clip":2,"text":"Stir"},
      {"clip":3,"text":"Steam milk"}, {"clip":4,"text":"Serve"}
    ]
  },
  "texts": [{"text":"Coffee in five steps","start":0,"duration":2,"y":0.2}],
  "aspect": "9x16"
}

timestamp: "source" 会为每个标签标注其在源文件中的片段起始时间（timeline 使用输出时间；none 仅显示文本）。除非 mute_teasers 为 false，否则预告剪辑会静音。你为 V2 片段、叠加效果或标题提供的所有时间都会因片头长度而向后移动，因此应按不带片头的编辑方式提供时间。视频中每个片段的时长都必须至少与其预告剪辑一样长（3 帧，即 0.1 秒，是任何片段的最短时长）。

标题还可以使用可选的 reveal，即在静止文本上进行矩形擦除：“"reveal":{"direction":"right","duration":0.5} 会让“咖啡的五个步骤”在半秒内从左边缘逐渐显现。所有字段均为可选，工具架构中列出了这些字段。标题会在你的电脑上绘制，带有 reveal 的标题需要 Pro 才能导出。

要让标题显示在人后方，请添加 occlusion：例如，“在这个片段的 1 到 4 秒之间，把标题‘Sunday reset’放在我身后、靠近顶部的位置，并使用柔和边缘”对应 "texts":[{"text":"Sunday reset","start":1,"duration":3,"y":0.25,"occlusion":{"clip":0,"feather":2}}]。clip 是 clips 中人物站在前方的片段索引；其他字段和规则见工具架构。人物会由随软件包提供的小型人物模型在你的电脑上识别，其相关信息不会离开你的电脑。让标题显示在人后方需要 Pro 才能导出。

动态示例

片段、标题和叠加层都可以选择添加 motion：为 x、y、scale、rotation 和 opacity 设置关键帧，让整个图层移动、缩放、旋转或淡入淡出。上面的动态提示词是一次 edit_video 调用：

{
  "clips": [{
    "path": "/absolute/clip.mp4", "track": "v1", "in": 0, "out": 4,
    "motion": {
      "scale": [{"at":0,"value":1,"easing":"ease-in-out"}, {"at":2,"value":1.2,"easing":"linear"}],
      "x": [{"at":0,"value":0,"easing":"hold"}, {"at":2,"value":0,"easing":"ease-in-out"}, {"at":3,"value":-0.15,"easing":"linear"}]
    }
  }],
  "texts": [{
    "text": "Watch this", "start": 0, "duration": 4,
    "motion": {"opacity": [{"at":0,"value":0,"easing":"ease-out"}, {"at":0.5,"value":1,"easing":"linear"}]}
  }],
  "aspect": "9x16"
}

每个关键帧的格式为 {at, value, easing}；对于素材，at 是源素材的秒数（照片使用自身时间轴，从其 in 开始）；对于标题和叠加层，则是从其自身开始时间算起的秒数。x 和 y 分别是输出宽度和高度的比例（正值表示向右和向下），scale 是缩放倍数，rotation 是顺时针旋转角度，opacity 的取值范围为 0–1。easing 用于调整关键帧之后的动画段，可选 hold、linear、ease-in、ease-out、ease-in-out，也可以使用自定义的 [x1, y1, x2, y2] 曲线，其中每个数字的取值范围为 0 到 1。第一个关键帧之前和最后一个关键帧之后，数值保持不变。zoom 用于在画面内设置静态取景；motion.scale 则用于缩放整个已放置的画面。每个通道最多可设 60 个关键帧，每次请求最多 1000 个。素材和标题的动态效果免费；目录叠加层只要设置了非默认的动态关键帧（包括免费预设），就需要 Pro。

音效示例

edit_video 可以从包含十种音效的内置免费音效包中添加短音效（点击、打字、呼啸、弹出和闪光音效，各两种）。音效会与片段同时播放，不会改变语音音量或视频时长，也不能替换为自己的文件或链接。上面的第一个提示词包含一个 sfx 列表：

{
  "clips": [{ "path": "/Users/me/take.mp4", "track": "v1", "out": 8 }],
  "texts": [{ "text": "My three tips", "start": 0.8, "duration": 2 }],
  "sfx": [
    { "asset": "ugc-click-01", "start": 1.2, "gain": 0.25 },
    { "asset": "ugc-pop-01", "anchor": { "kind": "title-enter", "text": 0 } }
  ],
  "aspect": "9x16"
}

音效可以从指定时间开始播放（按你描述的剪辑时间计算，即移除停顿或添加快速片头之前的时间；这些操作会让音效相应移动），也可以跟随标题出现、转场或叠加层点击。第二个提示词是 "auto_sfx": {"events": ["transition", "cta-tap"], "intensity": "subtle"}：Modisign 会在最终剪辑中为每个事件添加一个音效，任务结果会列出已添加和跳过的音效，例如未声明点击效果的叠加层。音效免费。

安装

Claude Desktop

将配置添加到 claude_desktop_config.json（macOS：~/Library/Application Support/Claude/claude_desktop_config.json；Windows：%APPDATA%\Claude\claude_desktop_config.json），然后重启：

{
  "mcpServers": {
    "modisign": { "command": "npx", "args": ["-y", "@modisign/mcp"] }
  }
}

Claude Code

在终端中运行此命令；请参阅 Claude Code MCP setup。

claude mcp add --transport stdio modisign -- npx -y @modisign/mcp

Codex CLI and ChatGPT/Codex desktop

在桌面应用中：Settings → MCP servers → Add server → STDIO，命令填写 npx，参数填写 -y @modisign/mcp，然后保存并重启；或者在 Codex CLI 中运行以下命令（设置说明）。

codex mcp add modisign -- npx -y @modisign/mcp

Cursor

将上面的 Claude Desktop JSON 放入 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目），然后在 MCP 设置中启用 Modisign。Cursor MCP setup。

VS Code / Copilot

创建 .vscode/mcp.json，然后启动服务并在提示时信任它（设置说明）。

{
  "servers": {
    "modisign": { "type": "stdio", "command": "npx", "args": ["-y", "@modisign/mcp"] }
  }
}

要求

Node.js 22 或更新版本。需要在 PATH 中配置 FFmpeg；助手可以为你运行以下命令：

• macOS：brew install ffmpeg
• Windows：winget install Gyan.FFmpeg
• Linux：sudo apt install ffmpeg

首次渲染时会下载一个私有渲染浏览器（约 100 MB）。 Linux ARM64：请改为安装 Chromium（sudo apt install chromium）。 运行 npx -y @modisign/mcp doctor 检查配置。

免费版和 Pro

每种叠加层类型都有一个免费预设，无需账户即可渲染；格式和背景更改也免费。
自定义叠加层（包括叠加层动态效果）、Pro 预设和富有表现力的字幕样式需要 Pro。
不含叠加层，或只使用未更改的免费预设以及 Clean、Boxed 或 Minimal 字幕的视频剪辑均免费，包括素材和标题动态效果、纯文本标题、快速片头和音效。带有揭示效果或显示在人像后方的标题需要 Pro。 Pro 价格为每月 $9：定价。使用 npx -y @modisign/mcp login 登录。

隐私

• 你的视频、照片和音频绝不会离开你的计算机。
• 只有叠加层设置、叠加层文本、所选字幕样式以及两个是／否事实（叠加层的动画是否经过自定义、标题是否使用揭示效果或 Behind people）会发送给 Modisign。
• 标题、快速开场标签、声音选择和动画键绝不会发送给 Modisign；你的助手会在请求中看到这些内容。
• 字幕在你的计算机上生成，使用的是从 Hugging Face 下载一次的英语语音模型（约 43 MB）。
• 匿名使用次数不会关联任何账户；设置 MODISIGN_NO_TELEMETRY=1 即可关闭遥测。

完整详情：https://modisign.app/privacy 和 TECHNICAL.md。

命令

使用 npx -y @modisign/mcp <command> 运行命令。

命令	功能
login	在浏览器中登录 Modisign。
logout	在这台计算机上退出登录。
status	检查登录状态和 Pro 访问权限。
doctor	检查设置。
render <family>/<preset>	将叠加层保存为 MP4、MOV 或 WebM。

许可证

MIT © 2026 Viacheslav Sierbov。第三方声明：NOTICE。从 modisign.app 获取的叠加层设计不受此许可证约束；详见 https://modisign.app/terms。