AI导哈

视频生成服务

一个通过MCP协议与Claude交互，使用Remotion创建、预览和渲染专业视频的服务。

  • by dev-arctik
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 dev-arctik/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工具

工具 说明
start_session 入职调查问卷——总是先打电话
init_project 搭建一个新的改造项目
scan_assets 扫描和分析assets文件夹中的图像、音频和字体
import_asset 将上传的文件从临时路径复制到项目的资产目录中
create_scene 使用模板或自定义动画创建新的场景文件
update_scene 修改现有场景的道具、动画或持续时间
delete_scene 从项目中删除场景
reorder_scenes 更改构图中场景的顺序
list_scenes 列出所有场景及其当前状态
update_composition 更新全局设置（样式、音频、尺寸）
write_file 将自定义代码文件（.tsx、.ts、.css、.json）写入项目
read_file 从项目中读取任何文件以供检查
add_overlay 将组件注册为持久全局覆盖
remove_overlay 从构图中去除覆盖层
start_preview 启动Remotion Studio开发服务器
stop_preview 停止开发服务器
capture_frame 将单个帧渲染为PNG以供查看
render_video 渲染最终视频（MP4/WebM）

音频模式

模式 需要输入 行为
叙事驱动 MP3+时间戳JSON 根据音频自动计算的视频持续时间。场景与旁白片段同步。
背景音乐 MP3文件 背景音乐循环播放。用户独立指定视频持续时间。
无音频 无 无声视频。用户指定持续时间。

技术栈

  • 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

许可证

麻省理工学院

相关 MCP