video-edit-mcp

🚀 视频编辑MCP服务器 🎬

这是一个强大的模型上下文协议（MCP） 服务器，专为高级视频和音频编辑操作而设计。该服务器允许MCP客户端（如Claude桌面版、Cursor等）通过标准化和统一的接口执行全面的多媒体编辑任务。

点击查看视频

✨ 主要特性

🎥 视频操作

• 基本编辑：裁剪、合并、调整大小、裁剪、旋转视频
• 特效处理：速度控制、淡入/淡出、灰度、镜像效果
• 叠加元素：添加带透明度的文本、图像或视频叠加层
• 格式转换：在不同格式之间进行转换，并可控制编解码器
• 帧操作：提取帧、从图像创建视频

🎵 音频操作

• 音频处理：提取、裁剪、循环、拼接音频
• 音量控制：调整音量、添加淡入/淡出效果
• 音频混合：混合多个音轨
• 音频集成：为视频添加音频、替换原声带

📥 下载与实用工具

• 视频下载：从YouTube等平台下载视频
• 文件管理：进行目录操作、列出文件
• 路径建议：获取推荐的下载位置

🧹 内存管理与清理

• 智能内存管理：链式操作无需保存中间文件
• 资源管理：清理内存、检查存储的对象
• 高效处理：将对象保留在内存中以实现复杂工作流程

🔗 操作链

可无缝链接多个操作，无需创建中间文件。通过多个步骤（裁剪 → 添加音频 → 应用特效 → 添加文本）处理视频，同时将所有内容保留在内存中以实现最佳性能。

📋 要求

• Python 3.10 或更高版本
• moviepy==1.0.3
• yt-dlp>=2023.1.6
• mcp>=1.12.2
• typing-extensions>=4.0.0

⚙️ 安装与设置

对于Claude桌面版 / Cursor MCP集成

确保已安装 uv。 如果未安装，请使用以下PowerShell命令进行安装：

powershell -ExecutionPolicy Bypass -Command "irm https://astral.sh/uv/install.ps1 | iex"

将以下配置添加到您的MCP配置文件中：

{
  "mcpServers": {
    "video_editing": {
      "command": "uvx",
      "args": [
        "--python",
        "3.11",
        "video-edit-mcp"
      ]
    }
  }
}

配置文件位置：

• Claude桌面版（Windows）：%APPDATA%/Claude/claude_desktop_config.json
• Claude桌面版（macOS）：~/Library/Application Support/Claude/claude_desktop_config.json
• Cursor：项目根目录下的 .cursor/mcp.json

手动安装

git clone https://github.com/Aditya2755/video-edit-mcp.git
cd video-edit-mcp
pip install -r requirements.txt
pip install -e .

🏗️ 项目结构

video_edit_mcp/
├── src/
│   └── video_edit_mcp/
│       ├── __init__.py
│       ├── main.py                 # MCP服务器实现  
│       ├── video_operations.py     # 视频编辑工具
│       ├── audio_operations.py     # 音频处理工具
│       ├── download_utils.py       # 下载功能
│       ├── util_tools.py          # 内存与实用工具
│       ├── utils.py               # 实用函数
│     
├── pyproject.toml                 # 项目配置
├── requirements.txt               # 依赖项
├── uv.lock                        # 锁文件
├── LICENSE                        # MIT许可证
├── MANIFEST.in                    # 清单文件
└── README.md

💻 使用示例

基础用法

# 链式操作无需中间文件
video_info = get_video_info("input.mp4")
trimmed = trim_video("input.mp4", 10, 60, return_path=False)  # 保留在内存中
with_audio = add_audio(trimmed, "background.mp3", return_path=False)  
final = add_text_overlay(with_audio, "Hello World", x=100, y=50, return_path=True)

🚀 未来改进与贡献

我们欢迎在以下令人兴奋的领域进行贡献：

🤖 人工智能功能

• 语音转文本（STT）：自动生成字幕和转录
• 文本转语音（TTS）：用于旁白的AI语音合成
• 音频增强：基于AI的降噪和音频质量改进
• 智能时间戳：自动场景检测和章节生成
• 人脸跟踪：高级人脸检测和跟踪以实现自动编辑
• 对象识别：根据检测到的对象进行跟踪和编辑
• 内容分析：基于AI的内容分类和标记

🤝 贡献方式

1. 分叉仓库
2. 创建功能分支：git checkout -b feature/amazing-feature
3. 提交更改：git commit -m 'Add amazing feature'
4. 推送到分支：git push origin feature/amazing-feature
5. 打开拉取请求

📄 许可证

本项目采用MIT许可证 - 有关详细信息，请参阅 LICENSE 文件。