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 文件。