MCP Video App - Setup & Run Instructions

MCP 视频应用 - 设置与运行说明

前置条件

• 已安装 Node.js（v14 或更高版本）
• 已安装 FFmpeg（视频处理所需）

项目结构

首先，为 MCP 视频应用创建一个项目文件夹：

mcp-video-app/
├── server.js         # Backend server code
├── package.json      # Project dependencies
├── public/           # Frontend static files
│   ├── index.html    # Main HTML file
│   ├── app.js        # Frontend JavaScript
│   └── styles.css    # CSS styles
├── uploads/          # Folder for uploaded videos
└── processed/        # Folder for processed videos

设置步骤

1. 创建项目文件夹并进入该文件夹

mkdir mcp-video-app
cd mcp-video-app

2. 初始化 Node.js 项目

npm init -y

3. 安装所需依赖项

npm install express cors multer morgan body-parser

4. 创建 server.js 文件 将“MCP 服务 - 后端设置”资源中的服务端代码复制到此文件中。

5. 创建用于上传和处理视频的目录

mkdir uploads
mkdir processed
mkdir public

6. 创建前端文件 创建 public/index.html，并将“MCP 视频应用 - 前端”资源中的 HTML 复制到该文件中。

7. 创建基本 CSS 文件（可选） 创建 public/styles.css，用于添加其他样式。

8. 创建前端 JavaScript 文件 创建 public/app.js，并将 HTML 文件中的 JavaScript 部分（<script> 标签内的所有内容）复制到该文件中。

运行应用

1. 启动服务

node server.js

2. 访问应用 打开 Web 浏览器并访问：

http://localhost:3000

故障排除

找不到 FFmpeg

如果遇到与 FFmpeg 相关的错误：

• 确认系统已安装 FFmpeg
• Windows：将 FFmpeg 添加到 PATH 环境变量中
• Mac：brew install ffmpeg
• Linux：sudo apt install ffmpeg

上传问题

如果上传视频时遇到问题：

• 检查 uploads 目录是否存在且具有写入权限
• 确认文件大小限制（默认为 100MB）
• 检查浏览器控制台是否有 JavaScript 错误

视频处理问题

如果视频处理失败：

• 确认 FFmpeg 已正确安装且可正常使用
• 检查服务端日志中是否有错误消息
• 先尝试使用较小的测试视频文件