JinDaGe - media-editor MCP Details

article

README

🚀 媒体编辑器

媒体编辑器是一个 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 许可证。

media-editor