∴ GitHub / 趋势仓库

kajisho5 / ffmpeg-skill

为编程智能体提供本地视频编辑能力,42 个 FFmpeg 工具,带 MCP 服务器

语言
Python
Star
7.4k
Fork
669
当日新增(11-17)
+367
累计在榜
1 天
最高名次
第 15 名
首次上榜
2026-11-17
去 GitHub 查看 ↗项目主页 ↗

∴ 是什么

这是一个将 FFmpeg 能力封装为 Agent Skill 的本地视频编辑工具集,供 Claude Code、Cursor、Codex 等编程智能体使用。它包含 42 个 Python 编写的独立工具,每个工具都有类型化参数和机器可读的契约,同时提供 MCP 服务器接口,智能体可以通过固定工作流(probe → edit → check → verify)完成视频剪辑、字幕、转场、响度归一化等任务。整体设计基于无云、无 API 密钥、仅依赖 Python 标准库的原则。

∴ 解决什么问题

  • 智能体直接调用 FFmpeg 时容易猜错帧率、选错容器不支持的编码、对只需流拷贝的文件进行重编码,且执行后不检查结果
  • 缺少结构化的工具接口,智能体需要手工构造 shell 字符串执行命令,容易出错
  • 视频编辑过程中无法验证输出是否符合目标规格,无法在交付前发现问题

∴ 怎么上手

  1. 01安装 FFmpeg:sudo apt install ffmpeg
  2. 02安装 skill:npx ffmpeg-skill
  3. 03检查机器环境:npx ffmpeg-skill doctor
  4. 04读取机器可读契约:npx ffmpeg-skill contract --json | head -40

∴ 适合谁

使用 Claude Code、Cursor、Codex 或任何支持 MCP 的智能体进行视频编辑的开发者;需要本地处理敏感视频素材、不愿上传到云端的用户。

∴ 要点

  • MIT 许可证,Python 标准库实现,无第三方依赖
  • 包含 42 个工具,覆盖剪辑、拼接、去静音、时长/纵横比适配、字幕与卡拉OK、叠加层、HDR 转 SDR、音频清理、多机位同步、响度归一化、交付检查、整片渲染等
  • 每个工具的 input_schema 由 argparse 解析器在运行时自动派生,CI 会检测契约漂移
  • MCP 默认只暴露核心 12 个工具以节省上下文,设置 FFMPEG_SKILL_MCP_FULL=1 可列出全部 42 个
  • 支持本地语音引擎(Parakeet 或 whisper)进行字幕转录,音频不会上传到云端
  • 已测试 FFmpeg 6.1、7.1、8 和 9 版本
许可证 MITagent-skillsai-agentsaudio-processingcaptionsclaude-codecodexcoding-agentcursorffmpeggemini-cli-extensionloudness-normalizationmcpmcp-servermodel-context-protocolpythonsubtitlestranscodingvideovideo-editingwhisper

解读由 AI 依据项目 README 生成,生成于 2026-11-17,以 GitHub 原文为准。

∴ 在榜记录

GitHub Trending 今日榜的每日存档,日期按北京时间。2026-11-17 首次上榜,累计在榜 1 天,最高第 15 名。

[object Object]2026-11-17 +367
每日新增 Star · 2026-11-17 至 2026-11-17 · 共 1 个在榜日峰值 +367
日期名次当日新增总 Star
#15+3677,379