[AI MediaKit MCP](https://www.volcengine.com/ats/mcp_detail?name=Mediakit%20Mcp) 是火山引擎 AI MediaKit 面向 AI 时代推出的标准能力插件。它基于 MCP（Model Context Protocol）协议，将云端专业的视频剪辑、音频处理、字幕处理、画质增强等原子能力封装为智能体可直观调用的工具。通过 AI MediaKit MCP，开发者可直接以自然语言驱动 AI 智能体完成复杂的云端媒体处理任务。 ## 工具概览 AI MediaKit MCP 已开放的能力覆盖了从异步任务查询到深度媒体编辑、视频增强的全流程。所有工具均支持通过“分组（Group）”或“工具名”进行动态加载，以优化智能体的推理效率。 |分类 |分组名称 |工具 |说明 | |---|---|---|---| |**通用能力** |shared |query_task |**任务查询**：查询异步任务状态和结果。提交异步任务后，使用该工具获取处理进度和最终产物。详细输入和输出参数请见 [query_task](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_mediakit/src/mediakit/mcp_tools/shared.py#L37)。 | |**视频工具** |video |erase_video_subtitle_pro |**视频字幕擦除**：针对视频中的字幕或文本进行高质量无痕擦除。详细输入和输出参数请见 [erase_video_subtitle_pro](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_mediakit/src/mediakit/mcp_tools/video.py#L156)。 | |||enhance_video |**画质增强**：面向 AIGC、UGC、短剧、教育、游戏、老片修复等场景提升视频画质。详细输入和输出参数请见 [enhance_video](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_mediakit/src/mediakit/mcp_tools/video.py#L99)。 | |**剪辑工具** |editing |add_image_to_video |**视频加图片**：在视频画面上叠加图片，常用于添加图片水印。详细输入和输出参数请见 [add_image_to_video](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_mediakit/src/mediakit/mcp_tools/editing.py#L44)。 | |||add_subtitle_to_video |**视频加字幕**：将字幕文件或字幕文本压制到视频画面中。详细输入和输出参数请见 [add_subtitle_to_video](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_mediakit/src/mediakit/mcp_tools/editing.py#L66)。 | |||adjust_video_speed |**视频播放调速**：调整视频播放速度，实现快放或慢放效果。详细输入和输出参数请见 [adjust_video_speed](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_mediakit/src/mediakit/mcp_tools/editing.py#L87)。 | |||concat_audio |**音频拼接**：将多个音频片段拼接为一个新的音频文件。详细输入和输出参数请见 [concat_audio](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_mediakit/src/mediakit/mcp_tools/editing.py#L103)。 | |||concat_video |**视频拼接**：将多个视频片段拼接为一个新视频，支持添加转场效果。详细输入和输出参数请见 [concat_video](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_mediakit/src/mediakit/mcp_tools/editing.py#L118)。 | |||extract_audio |**音频提取**：从视频文件中分离音频流，并保存为独立音频文件。详细输入和输出参数请见 [extract_audio](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_mediakit/src/mediakit/mcp_tools/editing.py#L134)。 | |||flip_video |**画面翻转**：对视频画面进行水平或垂直镜像翻转。详细输入和输出参数请见 [flip_video](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_mediakit/src/mediakit/mcp_tools/editing.py#L150)。 | |||image_to_video |**图片合成视频**：将多张图片合成为动画视频，支持转场效果。详细输入和输出参数请见 [image_to_video](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_mediakit/src/mediakit/mcp_tools/editing.py#L167)。 | |||mux_audio_video |**音画合成**：将视频轨道与音频轨道合成一个视频文件。详细输入和输出参数请见 [mux_audio_video](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_mediakit/src/mediakit/mcp_tools/editing.py#L183)。 | |||trim_audio |**音频裁剪**：按起止时间点裁剪音频，生成新的音频片段。详细输入和输出参数请见 [trim_audio](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_mediakit/src/mediakit/mcp_tools/editing.py#L203)。 | |||trim_video |**视频裁剪**：按起止时间点裁剪视频，生成新的视频片段。详细输入和输出参数请见 [trim_video](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_mediakit/src/mediakit/mcp_tools/editing.py#L220)。 | ## 快速体验：在 Trae 中配置 Trae 是一款 AI 原生 IDE，提供了强大的智能体协作能力。通过接入 AI MediaKit MCP ，您可以直接在 Trae 对话框中以自然语言方式调用云端媒体处理能力，快速完成视频剪辑、字幕处理、音频处理和画质增强等任务。 ### 前提条件 * 访问 AI MediaKit 控制台 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **AI MediaKit API Key**（用于媒体处理功能鉴权）。 * 已确认 AI MediaKit 服务接入地址。若未显式配置，默认使用 `https://amk.cn-beijing.volces.com`。 * 已安装 [Trae 客户端](https://www.trae.com.cn/)。 * 使用本地模式或云端自部署模式时，需确保本地开发环境已安装 `uvx`。可通过 `uvx --version` 检查；若提示未安装，请参考 [uv 官方安装文档](https://docs.astral.sh/uv/getting-started/installation/)。 ### 操作步骤 #### 步骤 1：选择接入模式根据您的使用场景，选择以下两种接入模式之一： |模式 |适用场景 |接入方式 | |---|---|---| |**本地模式（JSON Local）** |个人调试、快速试用、无需自建服务。 |通过 `uvx` 直接从 `mcp-server` 仓库子目录运行 AI MediaKit MCP。 | |**云端模式（JSON URL）** |团队共享、长期稳定使用、统一运维。 |先自行部署 AI MediaKit MCP Server，再使用部署后的 Streamable HTTP 地址接入。 | #### 步骤 2：添加 MCP 配置 1. 打开 Trae，单击窗口右上角“设置”（⚙️）按钮。 2. 在 MCP 页签下，单击**添加** \> **手动配置**。 3. 根据您在步骤 1 中选择的模式，复制对应 JSON 配置，并按下方说明替换参数。 **本地模式（JSON Local）** 复制以下 JSON 并根据下方文字说明进行替换。Trae 会通过 `uvx` 自动拉取远程代码并在本地运行。 ```JSON { "mcpServers": { "mediakit_mcp": { "command": "uvx", "args": [ "--from", "git+https://github.com/volcengine/mcp-server.git#subdirectory=server/mcp_server_mediakit", "mcp-server-mediakit" ], "env": { "MEDIAKIT_API_KEY": "your-api-key", "MEDIAKIT_ENDPOINT": "https://amk.cn-beijing.volces.com", "MCP_DOMAINS": "editing,video" } } } } ``` **字段替换说明：** * `mediakit_mcp`：MCP 服务名称，您可以根据需要自定义。 * `MEDIAKIT_API_KEY`：请替换为您的 AI MediaKit API Key。 * `MEDIAKIT_ENDPOINT`：AI MediaKit 服务地址。若使用默认接入地址，可保留 `https://amk.cn-beijing.volces.com`。 * `MCP_DOMAINS`：按分组加载工具，例如 `editing,video`。如需按工具名精确加载，可改用 `MCP_TOOLS`。如需按工具名加载，可参考以下写法： ```JSON { "mcpServers": { "mediakit_mcp": { "command": "uvx", "args": [ "--from", "git+https://github.com/volcengine/mcp-server.git#subdirectory=server/mcp_server_mediakit", "mcp-server-mediakit" ], "env": { "MEDIAKIT_API_KEY": "your-api-key", "MEDIAKIT_ENDPOINT": "https://amk.cn-beijing.volces.com", "MCP_TOOLS": "trim_video,query_task" } } } } ``` **云端模式（JSON URL）** 云端模式不提供现成的部署链接。使用该模式前，您需要先自行部署 AI MediaKit MCP Server，并确保服务可通过 Streamable HTTP 方式访问。部署完成后，请记录可访问的服务地址，例如 `https://your-domain/mcp`，然后在 Trae 中按如下方式接入。一种简单的启动示例如下： ```Bash export MEDIAKIT_API_KEY="your-api-key" export MEDIAKIT_ENDPOINT="https://amk.cn-beijing.volces.com" export MCP_SERVER_HOST="0.0.0.0" export MCP_SERVER_PORT="8000" export STREAMABLE_HTTP_PATH="/mcp" uvx --from "git+https://github.com/volcengine/mcp-server.git#subdirectory=server/mcp_server_mediakit" mcp-server-mediakit --transport streamable-http ``` 完成部署后，复制以下 JSON 并根据下方文字说明进行替换： ```JSON { "mcpServers": { "mediakit_mcp": { "url": "https://your-domain/mcp", "headers": { "x-amk-api-key": "your-api-key", "x-mediakit-endpoint": "https://amk.cn-beijing.volces.com", "x-mcp-domains": "editing,video" } } } } ``` **字段替换说明：** * `mediakit_mcp`：MCP 服务名称，您可以根据需要自定义。 * `url`：请替换为您自行部署后的 AI MediaKit MCP Streamable HTTP 地址，例如 `https://your-domain/mcp`。 * `x-amk-api-key`：请替换为您的 AI MediaKit API Key。 * `x-mediakit-endpoint`：AI MediaKit 服务地址。若使用默认接入地址，可填写 `https://amk.cn-beijing.volces.com`。 * `x-mcp-domains`：按分组加载工具，例如 `editing,video`。如需按工具名精确加载，可改用 `x-mcp-tools`。如需按工具名加载，可参考以下写法： ```JSON { "mcpServers": { "mediakit_mcp": { "url": "https://your-domain/mcp", "headers": { "x-amk-api-key": "your-api-key", "x-mediakit-endpoint": "https://amk.cn-beijing.volces.com", "x-mcp-tools": "trim_video,query_task" } } } } ``` 4. 确认该 MCP 的状态显示为绿色激活。 #### 步骤 3：启用智能体对话在 Trae 主界面打开对话面板，将底部智能体切换为支持 MCP 的模式。随后，您可以直接下达自然语言指令，例如： * 帮我把这个视频裁剪为前 10 秒，并输出一个新视频。 * 帮我给这个视频添加中文字幕，字号设置为 28。 * 帮我擦除视频底部字幕，并对处理后的视频做画质增强。 * 帮我把两段音频拼接起来，如果任务是异步的，请继续帮我查询最终结果。

说明

同步任务会直接返回结果；异步任务会返回 task_id，需要调用 query_task 查询任务状态和结果。

默认开启幂等，即相同账户和核心请求参数在 2 天内重复提交时，服务会直接返回首次任务结果，不会重复创建任务。如需主动控制幂等，可传 client_token；请求重试时复用同一值，强制重新执行时必须传新的唯一值。client_token 由客户端生成，长度不超过 64 个字符。

## MCP 配置参数说明下表列出 AI MediaKit MCP 的核心配置项，区分云端模式与本地模式。请根据您的实际接入场景选择对应字段。 |云端 Header 字段 |本地环境变量名 |示例 |说明 | |---|---|---|---| |x\-amk\-api\-key |MEDIAKIT_API_KEY |your\-api\-key |AI MediaKit API Key，用于请求鉴权。 | |x\-mediakit\-endpoint |MEDIAKIT_ENDPOINT |https://amk.cn\-beijing.volces.com |AI MediaKit 服务地址；未配置时默认使用该地址。 | |x\-mcp\-domains |MCP_DOMAINS |editing,video |按工具分组加载，多个分组用英文逗号分隔。 | |x\-mcp\-tools |MCP_TOOLS |trim_video,query_task |按工具名加载，多个工具名用英文逗号分隔。 | 云端自部署时，还可按需使用以下服务启动参数： |环境变量 |默认值 |说明 | |---|---|---| |`MCP_SERVER_HOST` |`0.0.0.0` |MCP 服务监听地址。 | |`MCP_SERVER_PORT` |`8000` |MCP 服务监听端口。 | |`STREAMABLE_HTTP_PATH` |`/mcp` |Streamable HTTP 路径。 | ## 工具详情 ### query_task 查询异步任务状态。支持单次查询，也支持通过 `poll_interval_seconds` 与 `max_poll_attempts` 控制轮询。 ### add_image_to_video 在视频中添加图片覆盖层，可用于图片水印。支持配置图片宽高、水平位置、垂直位置、开始时间和结束时间。 ### add_subtitle_to_video 将字幕文件或字幕文本压制到视频画面中。支持字幕位置、字体大小、字体颜色和字体类型配置。 ### adjust_video_speed 调整视频播放速度，实现快放或慢放效果。支持 `0.1` 到 `4` 倍速。 ### concat_audio 拼接多个音频片段，最多支持 100 个音频 URL。 ### concat_video 拼接多个视频片段，最多支持 100 个视频 URL，并可配置转场效果。 ### extract_audio 从视频中提取音频，支持输出 `mp3` 或 `m4a`。 ### flip_video 对视频画面进行水平或垂直镜像翻转。 ### image_to_video 将多张图片合成为动画视频，并支持配置转场效果。 ### mux_audio_video 将视频与音频合成为一个视频文件。支持保留原视频音频，并支持按视频或音频基准进行时长对齐。 ### trim_audio 按秒级起止时间裁剪音频文件。 ### trim_video 按秒级起止时间裁剪视频文件。 ### erase_video_subtitle_pro 针对视频中的字幕或文本进行高质量擦除，尽可能还原视频画面。支持 `mp4`、`flv`、`ts`、`avi`、`mov`、`wmv`、`mkv` 等主流视频格式。 ### enhance_video 针对 `common`、`ugc`、`short_series`、`aigc`、`old_film` 等场景进行画质增强，支持标准版和专业版工具版本。

智能处理