Video Editor MCP Server

🚀 視頻編輯 MCP 服務器

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

✨ 主要特性

工具

該服務器實現了一個關鍵工具：

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

📦 安裝指南

先決條件

1. 必須安裝 FFmpeg 並確保其在系統 PATH 中可用。
2. 需要 Python 3.9 或更高版本。
3. 所需的 Python 包：

   mcp
   httpx
   

安裝步驟

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

   # 使用 Homebrew 在 macOS 上
   brew install ffmpeg
   
   # 使用 Chocolatey 在 Windows 上
   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 命令前進行驗證。
• 對所有輸入參數進行清理。
• 報告詳細的與安全相關問題的錯誤消息。

貢獻

我們歡迎您為這個項目做出貢獻！請查看我們的 貢獻指南 以獲取詳細信息。

📄 許可證

此項目受 MIT License 保護。