🎬 Video Convert MCP

🎬 Video Convert MCP

🚀 基于 MCP (Model Context Protocol) 协议的专业视频格式转换工具，支持多格式转换、批量处理和质量控制

✨ 特性

• 🎯 多格式支持: 支持 MP4、AVI、MOV、MKV、WebM、FLV 等主流视频格式
• ⚡ 批量处理: 支持批量视频转换，提高工作效率
• 🎛️ 质量控制: 提供多种质量预设和编码选项
• 🔧 灵活配置: 支持自定义分辨率、帧率、比特率等参数
• 📊 进度监控: 实时显示转换进度和状态
• 🛠️ MCP 协议: 完全兼容 Model Context Protocol 标准

📦 安装

通过 npm 安装

npm install -g @pickstar-2002/video-convert-mcp

通过 npx 直接使用

npx @pickstar-2002/video-convert-mcp

🚀 使用方式

1. 作为 MCP 服务器使用

在您的 MCP 客户端配置中添加：

{
  "mcpServers": {
    "video-convert": {
      "command": "npx",
      "args": ["@pickstar-2002/video-convert-mcp"]
    }
  }
}

2. 在 Claude Desktop 中使用

编辑 claude_desktop_config.json 文件：

{
  "mcpServers": {
    "video-convert-mcp": {
      "command": "npx",
      "args": ["@pickstar-2002/video-convert-mcp"],
      "env": {}
    }
  }
}

3. 在 Cursor 中使用

在 .cursorrules 文件中添加：

# Video Convert MCP
Use @pickstar-2002/video-convert-mcp for video processing tasks

4. 在 Windsurf 中使用

在项目根目录创建 .windsurfrules 文件：

# Video Convert MCP Server
mcp_server: @pickstar-2002/video-convert-mcp

5. 作为 Node.js 模块使用

import { VideoConvertMCPServer } from '@pickstar-2002/video-convert-mcp';

const server = new VideoConvertMCPServer();
await server.start();

🎯 API 参考

主要工具

convertVideo

转换单个视频文件格式

{
  inputPath: string;      // 输入文件路径
  outputPath: string;     // 输出文件路径
  format: string;         // 目标格式 (mp4, avi, mov, mkv, webm, flv)
  quality?: string;       // 质量预设 (ultrafast, fast, medium, slow, veryslow)
  resolution?: {          // 目标分辨率
    width: number;
    height: number;
  };
  fps?: number;          // 目标帧率
  videoBitrate?: string; // 视频比特率
  audioBitrate?: string; // 音频比特率
}

batchConvert

批量转换多个视频文件

{
  inputDir: string;       // 输入目录
  outputDir: string;      // 输出目录
  format: string;         // 目标格式
  quality?: string;       // 质量预设
  filePattern?: string;   // 文件匹配模式
}

getVideoInfo

获取视频文件详细信息

{
  filePath: string;       // 视频文件路径
}

支持的格式

质量预设

• ultrafast - 最快速度，较大文件
• superfast - 超快速度
• veryfast - 很快速度
• faster - 较快速度
• fast - 快速度
• medium - 中等速度（默认）
• slow - 慢速度，较好质量
• slower - 更慢速度
• veryslow - 最慢速度，最佳质量

📋 系统要求

• Node.js >= 18.0.0
• FFmpeg (自动检测和安装提示)
• 支持的操作系统：Windows、macOS、Linux

🛠️ 开发

克隆项目

git clone https://github.com/pickstar-2002/video-convert-mcp.git
cd video-convert-mcp

安装依赖

npm install

构建项目

npm run build

开发模式

npm run dev

🤝 贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

🔗 相关链接

• Model Context Protocol
• FFmpeg 官网
• TypeScript 文档

📞 联系方式

如有问题或建议，欢迎联系：

微信: pickstar_loveXX

⭐ 如果这个项目对您有帮助，请给个 Star 支持一下！