🎬 Video Convert MCP
🚀 基于MCP协议的高性能视频格式转换工具，支持多种主流视频格式之间的无缝转换
✨ 特性
- 🎯 多格式支持 - 支持MP4、AVI、MOV、WMV、MKV、WEBM、M4V等主流视频格式
- ⚡ 高性能转换 - 基于FFmpeg引擎，转换速度快，质量可靠
- 🔧 灵活配置 - 支持自定义分辨率、码率、帧率等参数
- 📦 批量处理 - 支持批量视频转换，提高工作效率
- 🛡️ 类型安全 - 完整的TypeScript类型定义
- 🔌 MCP协议 - 基于Model Context Protocol，易于集成到AI应用中
📋 系统要求
- Node.js >= 16.0.0
- FFmpeg (需要安装并添加到系统PATH)
FFmpeg 安装指南
Windows:
# 使用 Chocolatey
choco install ffmpeg
# 或下载预编译版本
# https://ffmpeg.org/download.html#build-windows
macOS:
# 使用 Homebrew
brew install ffmpeg
Linux (Ubuntu/Debian):
sudo apt update
sudo apt install ffmpeg
🚀 安装
全局安装
npm install -g @pickstar-2002/video-convert-mcp
项目依赖
npm install @pickstar-2002/video-convert-mcp
🛠️ 使用方式
1. 命令行启动
# 全局安装后直接启动
video-convert-mcp
# 或使用 npx
npx @pickstar-2002/video-convert-mcp
2. 在 Claude Desktop 中使用
在 Claude Desktop 的配置文件中添加：
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"video-convert": {
"command": "npx",
"args": ["@pickstar-2002/video-convert-mcp"]
}
}
}
3. 在其他 MCP 客户端中使用
任何支持MCP协议的客户端都可以连接到此服务器：
# 启动服务器
npx @pickstar-2002/video-convert-mcp
4. 编程方式集成
import VideoMcpServer from '@pickstar-2002/video-convert-mcp';
const server = new VideoMcpServer();
await server.start();
🔧 支持的格式
| 格式 | 扩展名 | 描述 | 推荐用途 |
|---|
| MP4 | .mp4 | 最常用的视频格式 | 网络分享、移动设备 |
| AVI | .avi | 经典的视频容器格式 | 桌面播放 |
| MOV | .mov | Apple QuickTime格式 | Mac系统、专业编辑 |
| WMV | .wmv | Windows Media Video | Windows系统 |
| MKV | .mkv | 开源的多媒体容器 | 高质量存储 |
| WEBM | .webm | Web优化的视频格式 | 网页播放 |
| M4V | .m4v | iTunes兼容格式 | Apple生态系统 |
📖 API 文档
convert_video
转换单个视频文件格式
参数:
{
inputPath: string; // 输入视频文件路径
outputFormat: string; // 目标输出格式 (mp4, avi, mov, wmv, mkv, webm, m4v)
outputPath?: string; // 输出文件路径 (可选)
quality?: string; // 质量预设: low/medium/high/ultra
resolution?: string; // 分辨率，如 "1920x1080"
videoBitrate?: number; // 视频码率 (kbps)
audioBitrate?: number; // 音频码率 (kbps)
frameRate?: number; // 帧率 (fps)
overwrite?: boolean; // 是否覆盖已存在文件
}
示例:
{
"tool": "convert_video",
"arguments": {
"inputPath": "/path/to/input.mp4",
"outputFormat": "avi",
"quality": "high",
"resolution": "1920x1080"
}
}
get_video_info
获取视频文件详细信息
参数:
{
filePath: string; // 视频文件路径
}
返回:
{
filePath: string;
format: string;
size: number; // 文件大小 (字节)
duration: number; // 时长 (秒)
video?: {
codec: string;
width: number;
height: number;
frameRate: number;
bitrate: number;
};
audio?: {
codec: string;
sampleRate: number;
channels: number;
bitrate: number;
};
}
batch_convert
批量转换视频文件
参数:
{
inputFiles: string[]; // 输入文件列表
outputFormat: string; // 目标格式
outputDir: string; // 输出目录
quality?: string; // 质量预设
overwrite?: boolean; // 是否覆盖已存在文件
}
💡 使用示例
基本转换
将MP4文件转换为AVI格式：
{
"tool": "convert_video",
"arguments": {
"inputPath": "/Users/username/video.mp4",
"outputFormat": "avi"
}
}
高质量转换
转换为高质量的MKV格式：
{
"tool": "convert_video",
"arguments": {
"inputPath": "/Users/username/input.mp4",
"outputFormat": "mkv",
"quality": "high",
"resolution": "1920x1080",
"videoBitrate": 5000,
"audioBitrate": 192,
"frameRate": 30
}
}
批量转换
将多个视频文件批量转换为WEBM格式：
{
"tool": "batch_convert",
"arguments": {
"inputFiles": [
"/path/to/video1.mp4",
"/path/to/video2.avi",
"/path/to/video3.mov"
],
"outputFormat": "webm",
"outputDir": "/path/to/output",
"quality": "medium"
}
}
获取视频信息
{
"tool": "get_video_info",
"arguments": {
"filePath": "/path/to/video.mp4"
}
}
🎯 质量预设说明
| 预设 | 描述 | 适用场景 |
|---|
low | 低质量，文件小 | 快速预览、网络传输 |
medium | 中等质量 | 日常使用、社交分享 |
high | 高质量 | 专业用途、长期存储 |
ultra | 超高质量 | 专业制作、无损转换 |
🔧 开发
环境设置
# 克隆仓库
git clone https://github.com/pickstar-2002/video-convert-mcp.git
cd video-convert-mcp
# 安装依赖
npm install
# 构建项目
npm run build
# 开发模式
npm run dev
项目结构
src/
├── types/ # TypeScript类型定义
│ └── index.ts # 核心类型接口
├── services/ # 核心服务
│ └── validator.js # 参数验证服务
├── tools/ # MCP工具实现
│ └── index.js # 工具注册和处理器
└── index.ts # 服务器入口文件
🤝 贡献
欢迎提交Issue和Pull Request！
- Fork 项目
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 打开Pull Request
📄 许可证
本项目基于 MIT 许可证开源。
🙏 致谢
📞 联系方式
如有问题或建议，欢迎联系：
微信: pickstar_loveXX