diff --git a/server/mcp_server_mediakit/README.md b/server/mcp_server_mediakit/README.md new file mode 100644 index 00000000..d41f4480 --- /dev/null +++ b/server/mcp_server_mediakit/README.md @@ -0,0 +1,386 @@ +# MediaKit MCP Server + +MediaKit MCP Server is a standard AI capability plugin for Volcano Engine AI MediaKit. It is built on the MCP (Model Context Protocol) protocol and exposes cloud media capabilities such as video editing, audio processing, subtitle processing, and video enhancement as tools that can be called by AI agents. With MediaKit MCP, developers can use natural language to drive intelligent media production workflows. + +| Field | Value | +| --- | --- | +| Version | v1.0.0 | +| Description | MediaKit MCP intelligent media assistant | +| Categories | Media cloud, audio/video editing, video enhancement | +| Tags | MCP, MediaKit, video editing, audio processing, video enhancement | + +## Tool Overview + +MediaKit MCP provides tools that cover the full workflow from asynchronous task query to deep media editing and video enhancement. All tools support dynamic loading by group or by tool name to optimize agent reasoning efficiency. + +
| Category | +Group | +Tool | +Description | +
|---|---|---|---|
| Shared | +shared | +query_task | +Task query: Query asynchronous task status and results after submitting an asynchronous task. For detailed input and output parameters, see + query_task. + | +
| Video editing | +editing | +add_image_to_video | +Add image to video: Overlay an image on a video, commonly used for image watermarks. For detailed input and output parameters, see + add_image_to_video. + | +
| add_subtitle_to_video | +Add subtitles to video: Burn subtitle files or subtitle text into a video. For detailed input and output parameters, see + add_subtitle_to_video. + | +||
| adjust_video_speed | +Adjust video speed: Change video playback speed for fast or slow motion effects. For detailed input and output parameters, see + adjust_video_speed. + | +||
| concat_audio | +Concatenate audio: Merge multiple audio clips into a single audio file. For detailed input and output parameters, see + concat_audio. + | +||
| concat_video | +Concatenate video: Merge multiple video clips into a new video with optional transitions. For detailed input and output parameters, see + concat_video. + | +||
| extract_audio | +Extract audio: Separate the audio stream from a video and save it as an independent audio file. For detailed input and output parameters, see + extract_audio. + | +||
| flip_video | +Flip video: Flip a video horizontally or vertically. For detailed input and output parameters, see + flip_video. + | +||
| image_to_video | +Image to video: Create an animated video from multiple images with optional transitions. For detailed input and output parameters, see + image_to_video. + | +||
| mux_audio_video | +Mux audio and video: Combine a video track and an audio track into one video file. For detailed input and output parameters, see + mux_audio_video. + | +||
| trim_audio | +Trim audio: Trim an audio file by start and end time. For detailed input and output parameters, see + trim_audio. + | +||
| trim_video | +Trim video: Trim a video by start and end time. For detailed input and output parameters, see + trim_video. + | +||
| Video enhancement | +video | +erase_video_subtitle_pro | +Erase video subtitles: Remove subtitles or text from a video with high-quality restoration. For detailed input and output parameters, see + erase_video_subtitle_pro. + | +
| enhance_video | +Enhance video: Improve video quality for AIGC, UGC, short drama, education, gaming, and old film restoration scenarios. For detailed input and output parameters, see + enhance_video. + | +
| Cloud header | +Local environment variable | +Example | +Description | +
|---|---|---|---|
| x-amk-api-key | +MEDIAKIT_API_KEY | +your-api-key | +MediaKit API key used for authentication. | +
| x-mediakit-endpoint | +MEDIAKIT_ENDPOINT | +https://amk.cn-beijing.volces.com | +MediaKit service endpoint. The default value is this endpoint. | +
| x-mcp-domains | +MCP_DOMAINS | +editing,video | +Load tools by group. Separate multiple groups with commas. | +
| x-mcp-tools | +MCP_TOOLS | +trim_video,query_task | +Load tools by tool name. Separate multiple tool names with commas. | +
| 分类 | +分组名称 | +工具 | +说明 | +
|---|---|---|---|
| 通用能力 | +shared | +query_task | +任务查询:查询异步任务状态和结果。提交异步任务后,使用该工具获取处理进度和最终产物。详细输入和输出参数请见 + query_task。 + | +
| 视频剪辑 | +editing | +add_image_to_video | +视频加图片:在视频画面上叠加图片,常用于添加图片水印。详细输入和输出参数请见 + add_image_to_video。 + | +
| add_subtitle_to_video | +视频加字幕:将字幕文件或字幕文本压制到视频画面中。详细输入和输出参数请见 + add_subtitle_to_video。 + | +||
| adjust_video_speed | +视频播放调速:调整视频播放速度,实现快放或慢放效果。详细输入和输出参数请见 + adjust_video_speed。 + | +||
| concat_audio | +音频拼接:将多个音频片段拼接为一个新的音频文件。详细输入和输出参数请见 + concat_audio。 + | +||
| concat_video | +视频拼接:将多个视频片段拼接为一个新视频,支持添加转场效果。详细输入和输出参数请见 + concat_video。 + | +||
| extract_audio | +音频提取:从视频文件中分离音频流,并保存为独立音频文件。详细输入和输出参数请见 + extract_audio。 + | +||
| flip_video | +画面翻转:对视频画面进行水平或垂直镜像翻转。详细输入和输出参数请见 + flip_video。 + | +||
| image_to_video | +图片合成视频:将多张图片合成为动画视频,支持转场效果。详细输入和输出参数请见 + image_to_video。 + | +||
| mux_audio_video | +音画合成:将视频轨道与音频轨道合成一个视频文件。详细输入和输出参数请见 + mux_audio_video。 + | +||
| trim_audio | +音频裁剪:按起止时间点裁剪音频,生成新的音频片段。详细输入和输出参数请见 + trim_audio。 + | +||
| trim_video | +视频裁剪:按起止时间点裁剪视频,生成新的视频片段。详细输入和输出参数请见 + trim_video。 + | +||
| 视频增强 | +video | +erase_video_subtitle_pro | +视频字幕擦除:针对视频中的字幕或文本进行高质量无痕擦除。详细输入和输出参数请见 + erase_video_subtitle_pro。 + | +
| enhance_video | +画质增强:面向 AIGC、UGC、短剧、教育、游戏、老片修复等场景提升视频画质。详细输入和输出参数请见 + enhance_video。 + | +
| 云端 Header 字段 | +本地环境变量名 | +示例 | +说明 | +
|---|---|---|---|
| x-amk-api-key | +MEDIAKIT_API_KEY | +your-api-key | +MediaKit API Key,用于请求鉴权。 | +
| x-mediakit-endpoint | +MEDIAKIT_ENDPOINT | +https://amk.cn-beijing.volces.com | +MediaKit 服务地址;未配置时默认使用该地址。 | +
| x-mcp-domains | +MCP_DOMAINS | +editing,video | +按工具分组加载,多个分组用英文逗号分隔。 | +
| x-mcp-tools | +MCP_TOOLS | +trim_video,query_task | +按工具名加载,多个工具名用英文逗号分隔。 | +