MCP 工具文档
MCP Server 提供以下 8 个工具，连接后 AI 工具会自动发现并调用。
1. translate_video
提交视频翻译任务。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
videoPath | string | 是 | 视频文件路径（本地绝对路径或 HTTP(S) URL） |
sourceLanguage | string | 是 | 源语言代码 |
targetLanguage | string | 是 | 目标语言代码 |
title | string | 否 | 任务标题 |
translationStyle | string | 否 | 翻译风格，默认 standard |
startTime | number | 否 | 截取起始时间（秒） |
endTime | number | 否 | 截取结束时间（秒） |
removeSubtitles | boolean | 否 | 是否启用字幕抹除，默认 true |
denoiseBackground | boolean | 否 | 是否对背景音去噪（Step 2b 后，对 background.wav 去环境噪声、保留背景音乐），默认 false |
addSubtitles | boolean | 否 | 是否添加翻译字幕，默认 true |
subtitleMode | string | 否 | 字幕模式：hard（硬字幕）或 soft（软字幕），默认 hard |
progressbarTemplateId | number | 否 | 进度条模板 ID。-1 表示系统默认"鸭鸭进度条"，不传则不添加进度条 |
2. remove_subtitles
提交字幕抹除任务。自动检测并移除视频中的字幕区域。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
inputPath | string | 是 | 视频文件路径（本地绝对路径） |
outputPath | string | 否 | 输出路径，默认同目录生成 _no_sub 后缀文件 |
3. process_video
提交视频加工任务。支持转码、压缩、分辨率调整和竖屏裁切。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
inputPath | string | 是 | 视频文件路径（本地绝对路径） |
outputPath | string | 否 | 输出路径，默认存草稿目录 |
codec | string | 否 | 编码格式：h264、h265、av1，默认 h264 |
bitrate | string | 否 | 码率，如 5M、2000k |
resolution | string | 否 | 分辨率，如 1920x1080 |
crop | string | 否 | 裁切比例 9:16、3:4、1:1、4:5 或 w:h |
cropOffsetX | number | 否 | 裁切区域水平偏移（像素），默认居中 |
cropOffsetY | number | 否 | 裁切区域垂直偏移（像素），默认居中 |
startTime | number | 否 | 截取起始时间（秒） |
endTime | number | 否 | 截取结束时间（秒） |
4. check_status
查询任务状态（包含队列信息和步骤进度）。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
taskId | string | 是 | 任务 ID |
5. list_tasks
列出任务。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
status | string | 否 | 按状态筛选 |
6. get_languages
获取支持的语言列表和翻译风格。无参数。
7. cancel_task
取消任务。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
taskId | string | 是 | 任务 ID |
8. get_task_result
获取已完成任务的导出路径。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
taskId | string | 是 | 任务 ID |
9. add_watermark
为视频添加水印。需要先在客户端创建水印模板。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
inputPath | string | 是 | 视频文件本地绝对路径 |
templateId | number | 是 | 水印模板 ID |
outputPath | string | 否 | 输出路径，默认草稿目录 |
crf | number | 否 | 视频质量，默认 21 |
preset | string | 否 | 编码速度，默认 fast |
10. add_progressbar
为视频添加动态进度条。在视频底部叠加随播放进度增长的进度条和移动的头部图标（支持 GIF 动画），用于降低视频指纹相似度。templateId 传 -1 使用系统默认"鸭鸭进度条"。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
inputPath | string | 是 | 视频文件本地绝对路径 |
templateId | number | 是 | 进度条模板 ID，-1 = 系统默认 |
outputPath | string | 否 | 输出路径，默认草稿目录 |
crf | number | 否 | 视频质量，默认 21 |
preset | string | 否 | 编码速度，默认 fast |