用 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/contentasoftware/videorecompress-studio-plugin

三种自动化方式

• 命令行

  脚本、计划任务和批量运行。

• MCP 服务器

  AI 智能体可将 VideoRecompress 当作工具调用。

• Claude Code 技能

  Claude Code 会从你的 skills 文件夹学习这些命令。

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

可执行文件名为 videorecompress，与桌面应用一同安装 — 同一个安装包、同一份许可证。默认安装会将它放在 %LOCALAPPDATA%\Programs\VideoRecompressStudio\ 并把该文件夹加入 PATH，因此在任何新打开的终端中都可以直接运行 videorecompress。

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

videorecompress info video.mp4 --json

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

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

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

两个预设选项。--preset phone_archive 选择一个命名预设（编解码器、CRF 和预期节省）。--encoder-preset medium 设置编码器速度（ultrafast 到 veryslow）。命名预设请用 --preset，只有调整编码器速度时才用 --encoder-preset。

实用自动化方案

1. 定时归档任务

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

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

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

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

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

videorecompress watch 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 与 MCP 服务器一起打包在 VideoRecompress Studio 插件中，安装一次即可让智能体同时获得两者。只需两条命令：

/plugin marketplace add contentasoftware/videorecompress-studio-plugin
/plugin install videorecompress-studio@videorecompress-studio-plugin

在 Cursor、Claude Desktop、VS Code 或其他 MCP 客户端中，添加以下服务器配置（需要 Node.js 18 或更高版本）：

{
  "mcpServers": {
    "videorecompress-studio": { "command": "cmd", "args": ["/c", "npx", "-y", "@contentasoft/videorecompress-mcp"] }
  }
}

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

所有内容均在 GitHub 上有文档

插件源码、MCP 服务器参考和 CLI 文档都在公开的 GitHub 仓库中，启动器包已发布到 npm： github.com/contentasoftware/videorecompress-studio-plugin · npmjs.com/package/@contentasoft/videorecompress-mcp

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

常见问题