移动视频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": {}
}
}
}用法
- 与克劳德开始对话
- 说些类似的话 *“我想制作一个产品解说视频”*
- Claude引导您了解入职问题（目的、持续时间、音频、风格）
- Claude为项目搭建脚手架——直接在聊天中上传图像/音频，Claude会自动导入它们
- 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许可证
麻省理工学院