用 Contenta CLI、MCP 服务器和 AI 智能体自动化图像转换

2026年7月2日发布 · 阅读时间约9分钟

大多数人是通过 Windows 向导认识 Contenta Converter 的：拖入一个照片文件夹，选个格式，点击转换。但向导只是驱动它的一种方式。完全相同的转换引擎 — 100 多种格式、600 多款相机的 RAW、缩放、特效 — 同时还附带完整的命令行界面、内置 MCP 服务器，以及为 AI 编程智能体准备的现成技能。

本文将逐层介绍这三种用法：用 contenta CLI 编写脚本、把 MCP 服务器接入 Claude Desktop 或 Claude Code，以及让 AI 智能体根据一句自然语言请求跑完整条图像流水线。文中展示的一切都包含在标准安装包中 — 无需单独下载，也不需要额外许可证。

contenta CLI：同一个引擎，可脚本化

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

它提供 13 个命令：convert、batch、info、effects、formats、pdf-album、slideshow、ai-transform、watch、profile、register、status 和 serve。输入是位置参数 — 把命令指向文件或文件夹，再加上选项即可。把一张 Canon RAW 转成高质量 JPEG 只需一行：

contenta convert photo.cr2 --format jpg --quality 92

批量处理同样简单 — 指向一个文件夹即可。下面的命令把整个产品照片目录缩放到 2000 × 2000 像素以内并保存为 JPEG：

contenta batch ./photos --output ./ready --format jpg --resize 2000x2000 --resize-mode fit

每个命令都接受 --json 输出机器可读结果，并返回规范的退出码，因此 CLI 可以直接嵌入 PowerShell 脚本、bash 管道、CI 任务和计划任务。

实用自动化配方

两个模式覆盖了用户绝大多数的自动化需求。配置好之后都能无人值守运行。

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

watch 命令监控一个文件夹，自动转换每张新增或修改的图片。启动一次就持续运行 — 文件放进去，转换好的文件出来：

contenta watch ./incoming --output ./processed --format webp

通过任务计划程序设为登录时启动，你就拥有了一个零点击的转换服务：扫描件、手机照片和相机导入落入输入文件夹，几秒后网页就绪的 WebP 文件就出现在输出文件夹。

2. 电商缩放流水线

电商平台对图片尺寸要求严格 — 例如 Amazon 要求产品照片放在 2000 × 2000 的画布上。一条 batch 命令就能把存储卡里的照片变成可直接上传的文件夹：

contenta batch ./photos --output ./ready --format jpg --resize 2000x2000 --resize-mode fit

把它包进一个两行的脚本，每次新品拍摄只需一条命令就能从相机直达电商平台 — RAW 文件也不例外，因为引擎原生解码 600 多种相机格式。

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

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

contenta serve

它提供 10 个工具 — 单张与批量转换、格式检测、元数据读写、AI 背景移除、PDF 相册、幻灯片等 — 而且在免费试用期就能使用。要连接 Claude Desktop，在 claude_desktop_config.json 中加入：

{
  "mcpServers": {
    "contenta": {
      "command": "contenta",
      "args": ["serve"]
    }
  }
}

之后你就可以对助手说“把我下载文件夹里的所有 HEIC 转成 JPEG”，它会直接调用本地引擎。你的图片永远不会离开你的电脑 — 智能体负责指挥，转换在本地运行。

Claude Code 技能：用自然语言处理图片

如果您使用 Claude Code，技能 /contenta-image-processing 与 MCP 服务器一起打包在 Contenta Converter 插件中，安装一次即可让智能体同时获得两者。只需两条命令：

/plugin marketplace add contentasoftware/contenta-converter-plugin
/plugin install contenta-converter@contenta-converter-plugin

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

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

然后用自己的话描述任务即可：

• “把这个文件夹里的所有照片按 Amazon 和 Etsy 的要求缩放”
• “把这些 CR2 文件转成 92% 质量的 JPEG”

技能会把请求翻译成正确的 contenta 命令并执行，检查退出码，然后汇报结果。你审核方案，打字交给智能体。

一切都在 GitHub 上有文档

插件源码、MCP 服务器参考和 CLI 文档都在公开的 GitHub 仓库中，启动器包已发布到 npm：

github.com/contentasoftware/contenta-converter-plugin · npmjs.com/package/@contentasoft/contenta-converter-mcp

文档与产品同步维护，你在那里读到的内容与磁盘上的程序完全一致。可以把配方直接复制进自己的脚本；遇到边界情况欢迎提 issue。

常见问题