Provides video manipulation capabilities including video clipping, merging, and splitting through FFmpeg's processing engine, enabling precise time-based editing and format conversion.
Built on Node.js with specific version requirements (>=14.16.0), enabling cross-platform compatibility for the video processing tools.
🎬 Video Clip MCP
📖 项目简介
基于 AI MCP 协议的专业视频剪辑工具,提供高效的视频处理能力和智能化操作体验。无需手动安装 FFmpeg,开箱即用!
✨ 核心功能
🎯 精准剪辑 - 支持毫秒级精度的视频片段裁剪
🔗 智能合并 - 多视频文件无缝拼接,自动适配格式差异
✂️ 灵活分割 - 按时长、大小或段数智能分割视频
📊 信息获取 - 详细的视频元数据分析和格式检测
🚀 批量处理 - 高效的批量任务管理和并行处理
🎨 多格式支持 - 支持主流视频格式和编码标准
📈 任务监控 - 实时任务状态跟踪和进度管理
🛠️ 高度可配置 - 丰富的编码参数和质量预设
📦 安装使用
全局安装(推荐)
临时使用
🔧 MCP 服务器配置
Claude Desktop
在 claude_desktop_config.json
中添加:
Cursor AI
在 .cursorrules
或项目配置中添加:
WindSurf
在 windsurfconfig.json
中配置:
CodeBuddy
在项目根目录创建 .codebuddy/mcp.json
:
其他 MCP 兼容工具
通用配置格式:
💡 使用示例
基础视频剪辑
视频合并
视频分割
批量处理
🎥 支持格式
视频格式
输入格式: MP4, AVI, MOV, MKV, WebM, FLV, 3GP, WMV
输出格式: MP4, AVI, MOV, MKV, WebM
视频编码
H.264 (libx264) - 通用兼容性最佳
H.265 (libx265) - 高压缩比,文件更小
VP9 (libvpx-vp9) - 开源编码,适合网络传输
AV1 (libaom-av1) - 新一代编码,压缩效率极高
音频编码
AAC - 高质量音频编码
MP3 (libmp3lame) - 通用兼容性
Opus (libopus) - 低延迟高质量
Vorbis (libvorbis) - 开源音频编码
🖥️ 系统要求
Node.js 版本
最低要求: Node.js 18.0.0+
推荐版本: Node.js 20.0.0+
系统依赖
FFmpeg: 自动安装(通过 @ffmpeg-installer/ffmpeg 包)
操作系统: Windows 10+, macOS 10.15+, Linux (Ubuntu 18.04+)
推荐硬件配置
CPU: 4核心以上,支持硬件加速更佳
内存: 8GB RAM 以上
存储: SSD 硬盘,至少2GB可用空间
GPU: 支持硬件编码的显卡(可选)
📚 API 文档
核心接口定义
主要方法
🚨 疑难解答
常见问题及解决方案
1. 🔄 Connection closed 错误
问题描述: 使用 npx
时出现连接关闭错误
解决方案(按推荐顺序):
a. 首选方案 - 使用 @latest 标签
b. 备用方案 - 锁定特定版本
c. 终极方案 - 清理 npx 缓存
2. 🎬 FFmpeg 相关错误
问题描述: FFmpeg 执行失败或找不到
解决方案:
本工具已内置 FFmpeg,无需手动安装
如果仍有问题,请检查网络连接(首次使用需下载 FFmpeg)
确保有足够的磁盘空间(至少 100MB)
3. 📁 文件路径问题
问题描述: 输入或输出文件路径错误
解决方案:
使用绝对路径而非相对路径
确保路径中不包含特殊字符
Windows 用户注意使用正斜杠
/
或双反斜杠\\
4. 🔧 权限问题
问题描述: 没有文件读写权限
解决方案:
确保对输入文件有读取权限
确保对输出目录有写入权限
Windows 用户可能需要以管理员身份运行
5. 💾 内存不足
问题描述: 处理大文件时内存溢出
解决方案:
降低视频质量设置
分段处理大文件
增加系统虚拟内存
📞 获取帮助
如果以上解决方案无法解决您的问题,请:
📋 收集错误信息和系统环境
🐛 在 GitHub Issues 提交问题
💬 联系开发者(见下方联系方式)
🤝 贡献指南
我们欢迎所有形式的贡献!请遵循以下步骤:
Fork 本仓库
创建特性分支:
git checkout -b feature/amazing-feature
提交更改:
git commit -m 'Add amazing feature'
推送分支:
git push origin feature/amazing-feature
提交 Pull Request
开发环境设置
📄 许可证
本项目采用 MIT License 开源协议。您可以自由使用、修改和分发本软件。
🙏 致谢
感谢以下开源项目和社区的支持:
FFmpeg - 强大的多媒体处理框架
fluent-ffmpeg - Node.js FFmpeg 封装库
Model Context Protocol - AI 工具集成协议
TypeScript - 类型安全的 JavaScript 超集
开源社区 - 所有贡献者和用户的支持
🌟 支持项目
如果这个项目对您有帮助,请:
⭐ 给项目点个 Star
🐛 报告问题和建议
🔄 分享给更多开发者
让我们一起打造更好的视频处理工具!🚀
📞 联系方式
微信: pickstar_loveXX
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
A Model Context Protocol server that provides video manipulation capabilities, allowing users to clip, merge, and split video files through MCP integration.
Related MCP Servers
- AsecurityFlicenseAqualityA Node.js server that provides advanced video and image processing capabilities through the Model Context Protocol, enabling operations like conversion, compression, editing, and effects application.Last updated -10724
- -securityAlicense-qualityA Model Context Protocol server that provides file system operations, analysis, and manipulation capabilities through a standardized tool interface.Last updated -5MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables enhanced file system operations including reading, writing, copying, moving files with streaming capabilities, directory management, file watching, and change tracking.Last updated -17MIT License
- AsecurityFlicenseAqualityA comprehensive Model Context Protocol (MCP) server that provides 39 professional image processing tools including basic operations, geometric transformations, color adjustments, filter effects, and advanced batch processing capabilities.Last updated -391