remotion-mcp-server

一个 MCP（Model Context Protocol）服务器，让 Claude 能够分析参考视频并生成品牌化的 Instagram Reels / YouTube Shorts，使用 Remotion（基于 React 的程序化视频）——完全从聊天对话中完成。

让 Claude 分析一个参考短视频（reel），它可以：

1. 下载视频（yt-dlp），提取帧和音频，并获取完整转录文本（优先使用 YouTube 字幕，其他内容自动回退到 faster-whisper——包括 Instagram、TikTok、本地文件）。

2. 以相同的风格生成新的合成视频——对话气泡短视频或事实/列表式短视频——作为真正的 React/TSX 代码。

3. 使用 Remotion 渲染为 MP4。

4. 告诉你如何先在 Remotion Studio 中打开并逐帧检查，再决定是否将其作为最终版。

无需 CapCut，无需手动剪辑——Claude 编写视频。

工具

两个 create_* 工具都会返回一个 preview 提示，告诉 Claude/你在将渲染结果视为最终版本之前，如何在 Remotion Studio（npm run dev → localhost:3000）中打开该合成。

Related MCP server: cutgent

安装

1. 克隆并安装 Python 依赖

git clone https://github.com/<your-username>/remotion-mcp-server.git
cd remotion-mcp-server
pip install -r requirements.txt

你还需要在 PATH 中包含 ffmpeg（或安装 imageio-ffmpeg，服务器会自动回退使用它）。

2. 设置 Remotion 项目

此服务器需要一个 Remotion 项目来写入生成的 composition，并从中进行渲染。包含一个可直接使用的启动器：

cd remotion-template
npm install
cd ..

或者将 REMOTION_MCP_PROJECT 指向你自己的现有 Remotion 项目——它只需要在其 Root.tsx 中保留 remotion-template/src/Root.tsx 中的两个标记注释即可。

3. 配置（可选）

将 .env.example 复制为 .env，如果你不使用默认值，请进行调整（自定义 yt-dlp/ffmpeg 路径、不同的项目文件夹、默认水印）。

4. 注册到 Claude

将以下内容添加到你的 Claude Desktop / Claude Code MCP 配置中：

{
  "mcpServers": {
    "remotion-video": {
      "command": "python",
      "args": ["/absolute/path/to/remotion-mcp-server/server.py"]
    }
  }
}

重启 Claude，让它分析一个参考短视频，并为你生成一个同样风格的视频。

工作原理

• analyze_video 使用 yt-dlp 下载，使用 ffmpeg 提取帧和音频，然后进行转录：优先使用 youtube-transcript-api 获取 YouTube 字幕，其他所有情况则回退到本地 faster-whisper 转录。

• create_dialogue_reel / create_facts_reel 会模板生成一个 .tsx composition 文件，在该 Remotion 项目的 Root.tsx 标记注释之间注册它，并调用 npx remotion render。

• 生成的 composition 会通过热重载实时出现在 Remotion Studio（npm run dev）中——无需重启——因此你可以在将渲染结果视为最终版之前进行逐帧查看。

许可证

MIT —— 参见 LICENSE。