VibeVideo-MCP

VibeVideo-MCP 是一个由 HYE Partners 开发和维护的单仓（monorepo）项目，集成了 MCP 服务器 和 前端交互式视频编辑器，通过自然语言指令实现高效的视频编辑自动化。

该项目采用前后端分离架构，结合 Python、Node.js 和 React 技术栈，支持本地部署和 Docker 快速启动，适用于个人、研究及商业用途。

核心功能概览

• 支持通过自然语言调用 FFmpeg 进行视频处理
• 提供可视化编辑界面（React + Vite）
• 基于 MCP 协议的 AI 视频编辑代理服务
• 多模型兼容（如 command-r7b、devstral、llama3.1 等）
• 支持扩展非 FFmpeg 滤镜操作
• 可集成 CrewAI 等外部 AI 工作流框架

安装指南

✅ 系统要求

• Node.js（建议 v18+）
• npm / yarn / pnpm
• Python 3.12+（带 pip）
• 推荐操作系统：类 Unix（Mac/Linux），Windows 用户可使用 WSL 或 Docker

🔽 克隆仓库

git clone https://github.com/hyepartners-gmail/vibevideo-mcp.git
cd vibevideo-mcp

⚙️ 安装组件

1. FFmpeg 后端（Python）

cd ffmpeg-backend
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

如果尚未安装 ffmpeg，可通过以下命令补充：

pip install ffmpeg

2. FFmpeg 前端（React）

cd ffmpeg-frontend
npm install

🏗️ 项目结构与服务说明

本项目包含四个核心组件：

▶️ 启动方式

使用开发模式运行（推荐用于调试）

npm run dev

该命令将同时启动 React 前端和 Node 后端。

单独运行 Python 后端

cd ffmpeg-backend
python main.py

启动 Ollama 代理

cd ffmpeg-backend
python ollamarun.py

⚠️ 建议使用的模型（需支持函数调用）：

• command-r7b:latest
• devstral:latest
• qwen3:latest
• phi4-mini:latest
• mistral-nemo:latest
• llama3.1:8b
• llama3.3:latest
• qwen2.5-coder:latest
• firefunction-v2:latest

🐳 使用 Docker 快速部署（可选）

如果你希望快速部署而无需配置本地环境，可使用 Docker Compose 启动所有服务：

docker-compose up --build

默认开放端口如下：

Docker 设置中挂载了本地代码目录，支持热重载，方便边写边试。

📅 路线图更新（2025年6月3日）

• ✅ 改进时间轴编辑功能，完成渲染流程
• ✅ 添加仪表板指标与运行计数器
• ✅ 集成 CrewAI 连接器
• ✅ 支持部分非 FFmpeg 滤镜的 MCP 控制