Remotion Video MCP

移动视频mcp

MCP（模型上下文协议）服务器，允许Claude使用创建、预览和渲染专业视频 远程。自然地与Claude交谈——描述你想要的视频，提供资产，迭代场景——其余的由Claude处理。

运作原理

┌─────────────────┐       MCP Protocol        ┌──────────────────────┐
│  Claude CLI /    │ ◄────────────────────────► │  remotion-video-mcp  │
│  Claude Desktop  │   Tool calls & responses   │    (MCP Server)      │
└─────────────────┘                             └──────────┬───────────┘
                                                           │
                                                           │ File I/O + Process Mgmt
                                                           ▼
                                                ┌──────────────────────┐
                                                │   Remotion Project   │
                                                │   (in user's CWD)   │
                                                └──────────────────────┘

克劳德扮演着创造性大脑的角色。MCP服务器充当远程项目（渲染画布）的桥梁。用户描述他们想要什么，Claude使用MCP工具搭建脚手架、编写场景、同步音频、预览帧和渲染最终视频。

特性

• 对话式入职培训 --通过引导式问卷了解视频目标、风格和资产
• 项目脚手架 --使用预构建的模板组件创建完整的Remotion项目
• 场景管理 --通过自然语言创建、更新、删除和重新排序场景
• 音频同步 --具有字级时间戳同步的叙述驱动视频
• 实时预览 --启动Remotion Studio，以便在浏览器中实时预览
• 帧捕获 --渲染单个帧以便快速查看，而无需完整渲染
• 最终渲染 --以草稿、标准或高质量生成MP4/WebM输出
• 模板库 --TitleCard、TextScene、ImageScene、KineticTypography、CodeBlock等
• 自定义动画 --具有弹簧物理和缓动功能的对象级动画系统
• 资产进口 --将上传的图像、音频和字体从临时路径直接复制到项目中
• 自定义组件 --编写模板库之外的任意代码文件（主题、实用工具、组件）
• 覆盖系统 --在场景编辑后仍然存在的持久全局覆盖（徽标、水印、动画）

MCP工具

音频模式

技术栈

• MCP服务器：Node.js+TypeScript @modelcontextprotocol/server （MCP SDK v2）
• 视频引擎：Remotion v4（基于React的程序化视频）
• 运行时：Node.js 18+
• 包管理器：npm

先决条件

• Node.js 18+
• npm
• Claude CLI或Claude Desktop（用于MCP集成）

安装

# Clone the repository
git clone https://github.com/dev-arctik/remotion-video-mcp.git
cd remotion-video-mcp

# Install dependencies
npm install

# Build the server
npm run build

配置

将MCP服务器添加到您的Claude CLI或Claude Desktop配置中：

{
  "mcpServers": {
    "remotion-video": {
      "command": "node",
      "args": ["/path/to/remotion-video-mcp/dist/index.js"],
      "env": {}
    }
  }
}

用法

1. 与克劳德开始对话
2. 说些类似的话 *“我想制作一个产品解说视频”*
3. Claude引导您了解入职问题（目的、持续时间、音频、风格）
4. Claude为项目搭建脚手架——直接在聊天中上传图像/音频，Claude会自动导入它们
5. Claude创建场景、添加叠加、在浏览器中预览、迭代和渲染

项目结构

remotion-video-mcp/
├── src/
│   ├── index.ts                  # MCP server entry point
│   ├── server.ts                 # Server class with tool registration
│   ├── tools/                    # Individual MCP tool implementations
│   ├── state/                    # Project state management
│   ├── templates/                # Remotion component templates
│   └── utils/                    # File ops, process management, audio utils
├── templates/
│   └── project-scaffold/         # Template files for scaffolded projects
├── package.json
├── tsconfig.json
└── README.md

发展

# Build
npm run build

# Watch mode
npm run dev

# Type check
npm run typecheck

许可证

麻省理工学院