∴ GitHub / 趋势仓库
kajisho5 / ffmpeg-skill
为编程智能体提供本地视频编辑能力,42 个 FFmpeg 工具,带 MCP 服务器
- 语言
- Python
- Star
- 7.4k
- Fork
- 669
- 当日新增(11-17)
- +367
- 累计在榜
- 1 天
- 最高名次
- 第 15 名
- 首次上榜
- 2026-11-17
∴ 是什么
这是一个将 FFmpeg 能力封装为 Agent Skill 的本地视频编辑工具集,供 Claude Code、Cursor、Codex 等编程智能体使用。它包含 42 个 Python 编写的独立工具,每个工具都有类型化参数和机器可读的契约,同时提供 MCP 服务器接口,智能体可以通过固定工作流(probe → edit → check → verify)完成视频剪辑、字幕、转场、响度归一化等任务。整体设计基于无云、无 API 密钥、仅依赖 Python 标准库的原则。
∴ 解决什么问题
- 智能体直接调用 FFmpeg 时容易猜错帧率、选错容器不支持的编码、对只需流拷贝的文件进行重编码,且执行后不检查结果
- 缺少结构化的工具接口,智能体需要手工构造 shell 字符串执行命令,容易出错
- 视频编辑过程中无法验证输出是否符合目标规格,无法在交付前发现问题
∴ 怎么上手
- 01安装 FFmpeg:sudo apt install ffmpeg
- 02安装 skill:npx ffmpeg-skill
- 03检查机器环境:npx ffmpeg-skill doctor
- 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 名。