🎬 Video Clip MCP
🎥 基于 Model Context Protocol (MCP) 的视频剪辑工具，支持视频裁剪、合并和分割功能。
✨ 功能特性
- 🎯 视频裁剪: 按时间段精确裁剪视频片段
- ✂️ 视频分割: 将长视频按时长或大小智能分割
- 🔗 视频合并: 无损合并多个视频文件
- 🚀 MCP 集成: 完整支持 Model Context Protocol
- 💻 CLI 工具: 提供强大的命令行接口
- ⚡ 高性能: 基于 FFmpeg 的高效处理
📦 安装方式
全局安装
npm install -g video-clip-mcp
本地安装
npm install video-clip-mcp
开发依赖安装
npm install --save-dev video-clip-mcp
使用 Yarn
# 全局安装
yarn global add video-clip-mcp
# 本地安装
yarn add video-clip-mcp
使用 pnpm
# 全局安装
pnpm add -g video-clip-mcp
# 本地安装
pnpm add video-clip-mcp
直接运行（无需安装）
package.json 配置方式
{
"dependencies": {
"video-clip-mcp": "^1.0.0"
},
"devDependencies": {
"video-clip-mcp": "^1.0.0"
},
"scripts": {
"video-clip": "video-clip-mcp",
"clip": "video-clip clip",
"merge": "video-clip merge",
"split": "video-clip split"
}
}
ES6 模块导入
import { clipVideo, mergeVideos, splitVideo } from 'video-clip-mcp';
CommonJS 导入
const { clipVideo, mergeVideos, splitVideo } = require('video-clip-mcp');
MCP 配置方式
Claude Desktop 配置
在 claude_desktop_config.json 中添加：
{
"mcpServers": {
"video-clip-mcp": {
"command": "npx",
"args": ["video-clip-mcp"],
"env": {}
}
}
}
CodeBuddy 配置
在 CodeBuddy 的 MCP 设置中添加：
{
"video-clip-mcp": {
"command": "npx",
"args": ["video-clip-mcp"],
"env": {}
}
}
通用 MCP 客户端配置
{
"servers": {
"video-clip-mcp": {
"command": "npx",
"args": ["video-clip-mcp"],
"env": {}
}
}
}
本地安装后的配置
如果已全局安装，可以直接使用：
{
"video-clip-mcp": {
"command": "video-clip-mcp",
"args": [],
"env": {}
}
}
MCP 工具调用示例
{
"tool": "clip_video",
"arguments": {
"input": "input.mp4",
"output": "output.mp4",
"start": "00:01:00",
"end": "00:02:00"
}
}
🛠️ 系统要求
- Node.js: >= 14.16.0
- FFmpeg: 必须安装并添加到系统 PATH
- 操作系统: Windows, macOS, Linux
🚀 快速开始
作为 MCP 服务器运行
# 使用 npx（推荐）
npx video-clip-mcp
# 或全局安装后运行
video-clip-mcp
# 指定端口
PORT=8080 npx video-clip-mcp
作为命令行工具使用
🎯 视频裁剪
# 按时间段裁剪
video-clip clip -i input.mp4 -o output.mp4 -s 00:01:30 -e 00:02:45
# 按开始时间和持续时间裁剪
video-clip clip -i input.mp4 -o output.mp4 -s 00:01:30 -d 00:01:15
# 高质量裁剪
video-clip clip -i input.mp4 -o output.mp4 -s 10 -e 60 --quality high
🔗 视频合并
# 快速合并（推荐）
video-clip merge -i video1.mp4 video2.mp4 video3.mp4 -o merged.mp4
# 重新编码合并
video-clip merge -i video1.mp4 video2.mp4 -o merged.mp4 -r
# 批量合并
video-clip merge -i *.mp4 -o final.mp4
✂️ 视频分割
# 按时长分割（每5分钟）
video-clip split -i long-video.mp4 -o segment_%03d.mp4 -t time -v 00:05:00
# 按文件大小分割（每500MB）
video-clip split -i large-video.mp4 -o part_%03d.mp4 -t size -v 500M
# 自动分割（智能检测）
video-clip split -i video.mp4 --auto
📋 API 参考
MCP 工具列表
| 工具名称 | 功能描述 | 参数 |
|---|
clip_video | 裁剪视频片段 | input, output, start, end/duration |
merge_videos | 合并多个视频 | inputs, output, re-encode |
split_video | 分割视频文件 | input, pattern, type, value |
命令行参数
通用参数
-h, --help: 显示帮助信息-v, --version: 显示版本号--verbose: 详细输出模式--quiet: 静默模式
裁剪参数
-i, --input <file>: 输入视频文件-o, --output <file>: 输出视频文件-s, --start <time>: 开始时间-e, --end <time>: 结束时间-d, --duration <time>: 持续时间
🔧 开发指南
本地开发
# 克隆项目
git clone https://github.com/yourusername/video-clip-mcp.git
cd video-clip-mcp
# 安装依赖
npm install
# 启动开发服务器
npm run dev
# 运行测试
npm test
构建项目
发布到 npm
📊 使用统计
- 📦 包大小: ~7.2 kB
- 🚀 解压后: ~26.7 kB
- 📁 文件数量: 10 个
- ⭐ 支持格式: MP4, AVI, MOV, MKV 等
🤝 贡献指南
我们欢迎所有形式的贡献！
- 🍴 Fork 本项目
- 🌟 创建特性分支 (
git checkout -b feature/AmazingFeature) - 💾 提交更改 (
git commit -m 'Add some AmazingFeature') - 📤 推送到分支 (
git push origin feature/AmazingFeature) - 🔄 创建 Pull Request
📄 许可证
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
🔗 相关链接
💡 常见问题
Q: 如何安装 FFmpeg？
A: 请访问 FFmpeg 官网 下载并安装，确保添加到系统 PATH。
Q: 支持哪些视频格式？
A: 支持所有 FFmpeg 支持的格式，包括 MP4、AVI、MOV、MKV 等。
Q: 如何获得技术支持？
A: 请在 GitHub 上提交 Issue 或发送邮件至项目维护者。
⭐ 如果这个项目对您有帮助，请给我们一个 Star！