视频剪辑自动化工具

Director's Cut MCP Studio是一款基于Gradio和MCP的视频自动化剪辑工具,能够将长视频转换为适合社交媒体传播的竖屏短视频,支持智能剪辑、AI生成字幕和音乐等功能。

  • by tayyab415
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 tayyab415/directors-cut

使用说明


标题:导演剪辑MCP工作室 表情符号🎬 颜色来源:靛蓝 颜色To:紫色 sdk:毕业 sdk版本:6.0.0 app_file:app.py 固定:false 标签:

  • 建立mcp跟踪客户
  • mcp在行动多模式 许可证:mit

导演剪辑MCP工作室

Director’s Cut是一个Gradio+MCP空间,可以转换长格式的YouTube视频 进入病毒式垂直编辑。Claude Desktop(或任何MCP客户端)可以连接 到太空,呼叫暴露 gr.mcp.tool 函数,并获取完全渲染 融合了智能侦察、双子座计划、MoviePy编辑和 可选的生产抛光通行证(智能裁剪、AI介绍、字幕、音乐)。

亮点

  • MCP就绪UI –每个主要的工作流程步骤都包含 @gr.mcp.tool 因此Claude和web UI保持同步。
  • 拥抱面部友好存储 –所有运行时文件都位于 /tmp/directors-cut/...,这使Spaces部署保持无状态,同时 保留下载链接。
  • 多阶段编辑 –SignalScourt+验证器查找热点,总监 编写计划,Hands渲染它,Showrunner可以自动生成介绍, 农作物、潜艇和原声。
  • 智能日志 –通过Gradio UI和 终端,因此您可以在不接触MCP管道的情况下进行调试。

运作原理

  1. 扫描和分类 –下载音频,检测峰值,并将视频标记为 播客或通用来选择合适的管道。
  2. 验证和计划 –Gemini视觉/文本模型对热点进行评分,并组装一个 JSON编辑计划。
  3. 渲染 –MoviePy缝合剪辑,写入 /tmp/directors-cut/output.
  4. 制作工作室 –可选的Showrunner通行证添加了智能裁剪, FLUX生成了介绍图像、ElevenLabs钩子和基于Whisper的字幕。
  5. 智能下载 –完成的文件被复制到运行时输出中 目录,并通过MCP文件响应暴露给Claude。

MCP工具(摘录)

工具 目的
process_video 端到端的完全自主管道
scan_video, render_edit, render_and_produce_mcp 逐步控制
smart_crop_video, add_production_value_mcp 仅生产公用事业
get_youtube_info, classify_video_type 元数据助手

完整定义已发布 app.py 并镜像Gradio选项卡。

部署说明

  • 环境变量:set GEMINI_API_KEY, VIDEO_API_KEY, ELEVENLABS_API_KEY,以及 NEBIUS_API_KEY (可选但推荐)通过 空间秘密UI。没有它们,相应的功能会优雅地退化 (例如,字幕回退到无操作)。
  • 运行时存储器:覆盖默认值 /tmp/directors-cut 位置by 设置 DIRECTORS_CUT_RUNTIME_DIR 如果需要的话。
  • 港口:应用程序以以下方式启动 server_name="0.0.0.0" 和 server_port=7860,匹配HF Spaces默认值和Claude Desktop的MCP 期望。
  • 日志记录:stdout将流记录到Space控制台;Gradio进度框 为MCP客户端显示相同的消息。
  • ⚠️ YouTube下载限制:拥抱脸部空间限制外出 出于安全原因,您可以访问YouTube的网络。YouTube下载功能 不会在公共空间工作。 解决方法:
    1. 上传YouTube Cookie (最简单!):使用 浏览器扩展程序,并将其上传到Space UI中。看 COOKIES_SETUP.md 获取分步说明。不 需要外部服务!
    2. 部署YouTube代理服务:部署 youtube_proxy_service.py 到 铁路/渲染/Fly.io和设置 YOUTUBE_PROXY_URL 在空间设置中。 看 YOUTUBE_PROXY_SETUP.md 以获取说明。
    3. 本地使用:运行 python app.py 在您的计算机上查看完整的YouTube 下载功能
    4. 上传视频:使用Production Studio选项卡中的“上传视频”选项
    5. 仅限MCP:空间主要用于MCP文件下载(连接 克劳德桌面到空间URL)

本地开发

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env  # create and fill secrets
python app.py

Claude Desktop可以通过指向MCP服务器URL进行本地连接 Gradio印花(或 gradio_share_url.txt 文件(如果启用共享)。

资源

欢迎拉取请求和功能想法——只需保留文件处理 src/paths.py 因此Spaces部署仍然是可移植的。