用 CLI、MCP 服务器和 AI 智能体自动化视频压缩

2026年7月2日 • VideoRecompress Studio Team

大多数用户通过 Windows 向导使用 VideoRecompress Studio：拖入视频文件夹、选择预设、点击开始。但向导只是操作方式之一。相同的压缩引擎 — H.264、H.265、AV1、VP9、GPU 硬件编码 — 还提供名为 videorecompress 的完整命令行界面、内置 MCP 服务器和可安装的 Claude Code 技能。

本文介绍三个层面：用 videorecompress CLI 编写脚本、将 MCP 服务器接入 Claude Desktop 或 Claude Code，以及让 AI 智能体根据自然语言请求运行整条压缩流水线。完整 CLI 和 MCP 参考文档在公开 GitHub 仓库中。 github.com/brunojanvier77/ContentaSoft

videorecompress CLI：同一引擎，可脚本化

可执行文件名为 videorecompress，与桌面应用一同安装 — 同一安装包、同一许可证。位于 C:\Program Files\ContentaSoft\VideoRecompress Studio PREMIUM\；将该文件夹加入 PATH 即可在任何终端使用。

提供 9 个命令：analyze、recompress、batch、presets、profile、watch、status、register 和 serve。分析文件、按编解码器和 CRF 重新压缩，或批量处理整个文件夹 — 一行命令即可。

videorecompress analyze video.mp4 --json

videorecompress recompress video.mp4 --output ./compressed --preset-id phone_archive

videorecompress batch ./raw-footage --output ./archived --preset-id wedding_archive --workers 2

每个命令都支持 --json 输出机器可读结果（批量进度为 JSON 或 NDJSON）并返回规范的退出码，可直接嵌入 PowerShell 脚本、bash 管道、CI 任务和计划任务。

注意预设标志。 --preset-id phone_archive 选择命名的工作流预设（编解码器、CRF 和节省配置）。--preset medium 设置编码器速度（ultrafast 到 veryslow）。它们看起来相似但功能完全不同 — 工作流预设用 --preset-id，仅在调整编码速度时使用 --preset。

实用自动化方案

1. 定时归档任务

将 batch 指向原始素材文件夹，让它在夜间以质量优先预设重新压缩。一条命令将存储卡内容变成归档库：

videorecompress batch ./raw-footage --output ./archived --preset-id wedding_archive --workers 2

在任务计划程序中设为每周运行，相机导入将自动压缩 — 原文件不变，H.265 归档文件可长期保存。

2. 自动运行的监控文件夹

watch 命令监控文件夹并自动重新压缩每个新视频。启动一次即持续运行 — 文件放进去，压缩文件出来：

videorecompress watch --folder C:\Videos --preset phone_archive --output C:\Compressed

通过任务计划程序设为登录时启动，即可实现零点击压缩服务：手机视频、屏幕录制和相机导入进入输入文件夹，几秒后输出文件夹中出现更小的 H.265 文件。

MCP 服务器：把引擎交给 AI 智能体

MCP（Model Context Protocol）是 AI 助手调用外部工具的开放标准。VideoRecompress 内置 MCP 服务器 — 一条命令即可启动：

// claude_desktop_config.json
{
  "mcpServers": {
    "videorecompress": {
      "command": "videorecompress",
      "args": ["serve"]
    }
  }
}

提供 5 个工具 — 分析视频、重新压缩文件、批量处理、列出预设、估算空间节省 — 免费试用期内可用。要连接 Claude Desktop，在 claude_desktop_config.json 中添加：

之后您可以对助手说“用 phone_archive 预设重新压缩我下载文件夹中的所有 MP4”，它会直接调用本地引擎。您的视频从不离开您的电脑 — 智能体负责协调，压缩在本地运行。

Claude Code 技能：用自然语言压缩视频

如果使用 Claude Code，有更短的路径：/contenta-video 技能教会智能体整套 CLI — 命令、预设、硬件加速和常用方案。克隆公开仓库并复制技能即可安装：

git clone https://github.com/brunojanvier77/ContentaSoft.git
cp -r ContentaSoft/skills/* ~/.claude/skills/

然后用自己的话描述任务 — “用最高质量批量压缩这个婚礼文件夹” 或 “监控我的屏幕录制文件夹并压缩新文件”。技能会转换为正确的 videorecompress 命令并汇报结果。

所有内容均在 GitHub 上有文档

完整参考文档在公开 GitHub 仓库中：每个命令和选项的准确 CLI 文档、5 个工具的完整 MCP 服务器参考，以及 VideoRecompress Studio 和其他 ContentaSoft 产品的可安装 Claude Code 技能。 github.com/brunojanvier77/ContentaSoft

文档与产品同步维护，您在那里读到的内容与磁盘上的程序一致。可将方案直接复制到自己的脚本中，或遇到边界情况时提 issue。

常见问题

CLI 需要额外付费吗？

不需要。CLI、MCP 服务器和 Claude Code 技能与桌面应用打包在同一安装程序中，由同一份 $79 一次性许可证覆盖。

免费试用期内可用吗？

可以。30 天免费试用期也覆盖 CLI 和 MCP 服务器。前 10 个文件无水印压缩；之后输出带有小水印并截取为前 10 分钟，直到用 videorecompress register 注册。

可以在脚本和 CI 流水线中使用吗？

这正是其设计目的。每个命令支持 --json 结构化输出并返回有意义的退出码（0 成功、3 需要许可证、5 文件未找到等）。