Skip to main content
Glama

video-editor-mcp

一个 MCP(Model Context Protocol)服务器,为 Claude 提供一套完整的对话式视频编辑工具包 — 修剪、裁剪、调色、添加字幕、节拍同步、稳定等 — 基于 ffmpeg、faster-whisper 和 yt-dlp 构建,并可选择集成 DaVinci Resolve 和 CapCut。

在聊天中描述你想要的编辑效果;Claude 会调用工具来执行。

工具

类别

工具

下载

download_video — 支持从 YouTube、Instagram、TikTok、Facebook、Vimeo 或任何直接链接下载(通过 yt-dlp 支持 1000+ 站点)

分析

get_video_info、detect_scenes、analyze_style — 探测文件,或逆向分析参考片的剪辑节奏、色彩基调和画面方向

基础编辑

trim_video、merge_videos、extract_audio、change_speed、add_audio —

视觉

color_grade(cinematic/bright/moody/vibrant/bw/vintage 预设)、add_text_overlay、crop_and_resize(9:16/1:1/16:9/4:5)、stabilize_video

AI

auto_captions — 基于 Whisper,可烧录字幕或导出 .srt,支持多语言

智能编辑

edit_like_reference — 分析参考片的节奏/色彩/方向,并重新剪辑你的素材以匹配;beat_sync_edit — 根据检测到的音乐节拍剪辑素材;auto_best_moments — 从长段原始素材中提取精彩集锦

批处理

batch_process — 对文件夹中的每个视频执行同一操作

分享

share_file — 上传结果并获得可分享的链接(gofile/transfer.sh)

DaVinci Resolve(可选)

davinci_status、davinci_create_timeline — 仅在安装了 Resolve 时启用

CapCut(可选)

list_capcut_drafts、launch_capcut — 仅在安装了 CapCut 时启用

Related MCP server: Video MCP

设置

1. 克隆并安装 Python 依赖

git clone https://github.com/dr-ashraf-s-MCP-LABS/video-editor-mcp.git
cd video-editor-mcp
pip install -r requirements.txt

你还需要在 PATH 中提供 ffmpeg(或 imageio-ffmpeg,服务器会自动回退到它)以及 yt-dlp。

2. 配置(可选)

将 .env.example 复制为 .env。如果你需要非默认的二进制文件位置、想指向自己的 CapCut/DaVinci 安装,或需要 cookies.txt 来下载 Instagram/Facebook 内容(可以用浏览器扩展如“Get cookies.txt LOCALLY”导出一个),请进行相应调整。

3. 注册到 Claude

将以下内容添加到你的 Claude Desktop / Claude Code MCP 配置中:

{
  "mcpServers": {
    "video-editor": {
      "command": "python",
      "args": ["/absolute/path/to/video-editor-mcp/server.py"]
    }
  }
}

重启 Claude,然后开始通过对话进行编辑,例如:“下载这个 Reel,让它的风格与我的原始素材匹配,添加这段音乐,并加上字幕。”

备注

  • 默认情况下,download_video、output 以及下载的文件会放在 server.py 旁边的 ./downloads 和 ./output 目录中 — 可通过 VIDEO_EDITOR_DOWNLOADS_DIR / VIDEO_EDITOR_OUTPUT_DIR 覆盖。

  • 如果你尚未设置相关的环境变量,或没有安装这些应用,CapCut 和 DaVinci Resolve 工具会优雅地降级(报告“not installed”)。

  • auto_captions 和 batch_process 的字幕模式会在首次使用时下载 Whisper base 模型(~150MB)。

许可证

MIT — 参见 LICENSE。

Related MCP Connectors

Related MCP Servers