Media Editor

🚀 媒體編輯器

媒體編輯器是一個 MCP（模型上下文協議）服務器，它提供了用於編輯媒體文件的工具。你可以將其與 Claude 或其他支持 MCP 的 AI 助手結合使用，以自動化處理視頻和音頻任務。

✨ 主要特性

• 視頻裁剪 - 將視頻文件裁剪到特定的時間範圍。
• 音頻轉錄 - 使用 NVIDIA NeMo 將語音轉換為文本。
• 主題縮略圖 - 生成帶有可定製主題的標題卡片，並將其添加到視頻開頭。

📦 安裝指南

前提條件

• Python 3.12 及以上版本
• uv 包管理器
• FFmpeg（必須安裝並添加到系統環境變量中）
• 支持 CUDA 的 NVIDIA GPU（用於轉錄）

安裝步驟

此倉庫使用 Git LFS 來存儲測試視頻文件。在克隆之前，請先安裝 Git LFS：

# 安裝 Git LFS（macOS）
brew install git-lfs

# 初始化 Git LFS
git lfs install

然後克隆並安裝項目：

# 克隆倉庫（LFS 文件會自動獲取）
git clone https://github.com/wmeints/media-editor.git
cd media-editor

# 安裝依賴
uv sync

驗證安裝

運行 doctor 命令來檢查所有必需的依賴項是否已安裝並可用：

uv run media-editor doctor

如果成功，你將看到 FFmpeg 的路徑。如果缺少 FFmpeg，請安裝它並確保它已添加到系統環境變量中。

🚀 快速開始

運行 MCP 服務器

uv run media-editor mcp

連接到 Claude 桌面版

將以下內容添加到你的 Claude 桌面版配置文件（claude_desktop_config.json）中：

{
  "mcpServers": {
    "media-editor": {
      "command": "uv",
      "args": ["run", "media-editor", "mcp"],
      "cwd": "/path/to/media-editor"
    }
  }
}

💻 使用示例

開發相關命令

# 運行測試
uv run pytest

# 類型檢查
uv run pyright

# 代碼檢查
uv run ruff check src/
uv run ruff format src/

📄 許可證

本項目採用 MIT 許可證。