Video Editor (FFMpeg)

🚀 視頻編輯 MCP 服務器

這是一個功能強大的視頻編輯 MCP 服務器，它藉助 FFmpeg，能依據自然語言命令執行各類視頻編輯操作，為視頻處理帶來極大便利。

✨ 主要特性

工具

服務器實現了一個核心工具：

• execute_ffmpeg：可執行帶有進度跟蹤的 FFmpeg 命令。
  • 接收命令字符串作為輸入。
  • 驗證並執行 FFmpeg 操作。
  • 即時報告處理進度。
  • 處理錯誤並提供詳細反饋。
  • 支持所有 FFmpeg 操作，涵蓋：
    • 裁剪/剪輯
    • 合併視頻
    • 轉換格式
    • 調整速度
    • 添加音頻軌道
    • 提取音頻
    • 添加字幕
    • 基本濾鏡（亮度、對比度等）

📦 安裝指南

先決條件

1. FFmpeg 必須已安裝，且能在系統 PATH 中訪問。
2. 需要 Python 3.9 或更高版本。
3. 所需的 Python 包：

   mcp
   httpx
   

安裝步驟

1. 若尚未安裝 FFmpeg，可按以下方式安裝：

   # 在 macOS 上使用 Homebrew
   brew install ffmpeg
   
   # 在 Windows 上使用 Chocolatey
   choco install ffmpeg
   
   # 在 Ubuntu/Debian 上
   sudo apt install ffmpeg
   

2. 安裝視頻編輯包：

   uv add video-editor
   

Claude 桌面集成

在您的 Claude Desktop 配置文件中進行如下配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "video-editor": {
      "command": "uv",
      "args": ["run", "video-editor"]
    }
  }
}

💻 使用示例

基礎用法

一旦連接到 Claude Desktop，您可以發出自然語言請求，例如：

1. "將 video.mp4 從 1:30 到 2:45 裁剪"
2. "將 input.mp4 轉換為 WebM 格式"
3. "將 video.mp4 的速度加快 2 倍"
4. "合併 video1.mp4 和 video2.mp4"
5. "從 video.mp4 中提取音頻"
6. "將 subtitles.srt 添加到 video.mp4"

服務器會執行以下操作：

1. 解析您的請求。
2. 生成適當的 FFmpeg 命令。
3. 執行並進行進度跟蹤。
4. 在完成時提供反饋。

📚 詳細文檔

開發

構建和發佈

1. 同步依賴項：

   uv sync
   

2. 構建包：

   uv build
   

3. 發佈到 PyPI：

   uv publish
   

注意：可通過以下方式設置 PyPI 憑據：

• 令牌：--token 或 UV_PUBLISH_TOKEN
• 或用戶名/密碼：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

調試

為獲得最佳調試體驗，請使用 MCP 檢查器：

npx @modelcontextprotocol/inspector uv --directory /path/to/video_editor run video-editor

錯誤處理

服務器具備強大的錯誤處理功能，可處理以下情況：

• 無效的輸入文件
• 格式錯誤的 FFmpeg 命令
• 運行時執行錯誤
• 進度跟蹤問題

所有錯誤都會詳細報告給客戶端，方便進行調試。

安全注意事項

• 只處理顯式允許目錄中的文件。
• 驗證 FFmpeg 命令在執行前的有效性。
• 對所有輸入參數進行清理。
• 報告與安全相關的詳細錯誤消息。

貢獻

歡迎貢獻代碼！請按以下步驟操作：

1. Fork 這個倉庫。
2. 創建一個新的分支用於您的功能：git checkout -b feature/your-feature
3. 提交您的更改：git commit -m '描述您的修改'
4. 推送到遠程倉庫：git push origin feature/your-feature
5. 創建一個 Pull Request。

請確保在提交之前檢查代碼格式和文檔是否符合要求。