feat: vod mcp tools support

Author: zakahan

docs/docs/tools/builtin.md

@@ -70,6 +70,7 @@ VeADK 集成了以下火山引擎工具：
 | `lark` | 集成[飞书开放能力](https://open.larkoffice.com/document/uAjLw4CM/ukTMukTMukTM/mcp_integration/mcp_installation)，实现文档处理、会话管理等。 | `from veadk.tools.builtin_tools.lark import lark` |
 | `las` | 基于[火山引擎 AI 多模态数据湖服务 LAS](https://www.volcengine.com/mcp-marketplace) 进行数据管理。 | `from veadk.tools.builtin_tools.las import las` |
 | `mobile_run` | 手机指令执行   | `from veadk.tools.builtin_tools.mobile_run import create_mobile_use_tool` |
+| `vod`      | 视频剪辑助手   | `from veadk.tools.builtin_tools.vod import vod_tools` |
 
 ### 公域搜索 (Web Search)
 
@@ -592,7 +593,82 @@ VeADK 集成了以下火山引擎工具：
 运行结果：
 ![img_2.png](../assets/images/tools/mua_3.png)
 
+### 视频云MCP工具（Vod MCP Tool）
 
+`vod_tools`允许Agent通过调用火山引擎的视频云MCP来进行视频剪辑处理，详情请参考[VOD MCP Server](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_vod/README_zh.md)
+
+!!! warning "使用 `vod_tools` 的附加要求"
+    1. 需要配置火山引擎 AK、SK
+    2. （可选）可以配置`TOOL_VOD_GROUPS`选择多样化的视频剪辑能力。可选范围为：
+        - `edit`:视频剪辑相关tools
+        - `intelligent_slicing`: 智能切片相关tools
+        - `intelligent_matting`: 智能抠图相关tools
+        - `subtitle_processing`: 字幕处理相关tools
+        - `audio_processing`: 音频处理相关tools
+        - `video_enhancement`: 视频增强相关tools
+        - `upload`: 上传相关
+        - `video_play`: 视频播放相关
+    3. （可选）工具连接超时时长`TOOL_VOD_TIMEOUT`，默认为10秒
+    - 注：如果需要多个工具组，请使用逗号进行连接，如果不进行配置，则默认为`edit,video_play`
+    - 注：视频云工具不支持Space的创建，请在火山视频云控制台提前创建[视频云空间](https://console.volcengine.com/vod/region:vod+cn-north-1/overview/)
+
+
+=== "代码"
+
+    ```python
+    import asyncio
+    from veadk import Agent, Runner
+    from veadk.tools.builtin_tools.vod import vod_tools
+    agent = Agent(tools=[vod_tools])
+    runner = Runner(agent)
+    result = asyncio.run(
+        runner.run(
+            messages="将这两个视频合并:<your-url1>, <your-url2>, space_name为<your-space-name",
+        )
+    )
+    print(result)
+    ```
+
+=== "环境变量"
+
+    必须配置在环境变量的配置项：
+
+    - `VOLCENGINE_ACCESS_KEY`：  火山引擎的AccessKey
+    - `VOLCENGINE_SECRET_KEY`：  火山引擎的SecretKey
+
+    可选环境变量
+    - TOOL_VOD_GROUPS: 配置能力组
+    - TOOL_VOD_TIMEOUT: 工具连接超时时长, 默认为10.0秒
+
+    或在 `config.yaml` 中定义：
+
+    ```yaml title="config.yaml"
+    model:
+      agent:
+        provider: openai
+        name: doubao-seed-1-6-250615
+        api_base: https://ark.cn-beijing.volces.com/api/v3/
+        api_key: your-api-key-here
+    volcengine:
+      access_key: you-access-key-here
+      secret_key: you-secret-key-here
+    tool:
+      vod: 
+        groups: xxxxx
+        timeout: 10.0
+    ```
+
+输出结果：
+```text
+已成功将两个视频合并，合并后的视频信息如下：
+- **播放地址**：<url>
+- **视频时长**：x秒 
+- **分辨率**：xxxxx
+- **文件名称**：xxxxx.mp4  
+（注：播放地址有效期为60分钟，若过期可重新生成）
+```
+
+注：有些视频编辑任务可能时间开销较大，该类任务会直接返回一个task_id，可以继续询问agent，让其查询task是否完成，从而获得任务后续。
 
 ## 系统工具
 

veadk/tools/builtin_tools/vod.py

@@ -0,0 +1,71 @@
+# Copyright (c) 2025 Beijing Volcano Engine Technology Co., Ltd. and/or its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+from google.adk.tools.mcp_tool import StdioConnectionParams
+from google.adk.tools.mcp_tool.mcp_toolset import StdioServerParameters, McpToolset
+
+from veadk.config import getenv
+from veadk.utils.logger import get_logger
+
+logger = get_logger(__name__)
+
+
+def _get_vod_envs() -> dict[str, str]:
+    """
+    note, available `TOOL_VOD_GROUPS`:
+        "edit",  # Tools related to video editing
+        "intelligent_slicing",  # Tools related to intelligent slicing
+        "intelligent_matting",  # Tools related to intelligent matting
+        "subtitle_processing",  # Tools related to subtitle processing
+        "audio_processing",  # Tools related to audio processing
+        "video_enhancement",  # Tools related to video enhancement
+        'upload',  # Related to upload
+        "video_play"  # Related to video playback
+    https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_vod/src/vod/mcp_server.py#L14
+    """
+
+    ak = getenv("VOLCENGINE_ACCESS_KEY", None)
+    sk = getenv("VOLCENGINE_SECRET_KEY", None)
+
+    if os.getenv("TOOL_VOD_GROUPS", None):
+        return {
+            "VOLCENGINE_ACCESS_KEY": ak,
+            "VOLCENGINE_SECRET_KEY": sk,
+            "MCP_TOOL_GROUPS": getenv("TOOL_VOD_GROUPS"),
+        }
+    else:
+        return {
+            "VOLCENGINE_ACCESS_KEY": ak,
+            "VOLCENGINE_SECRET_KEY": sk,
+        }
+
+
+_vod_envs = _get_vod_envs()
+
+vod_tools = McpToolset(
+    connection_params=StdioConnectionParams(
+        server_params=StdioServerParameters(
+            command="uvx",
+            args=[
+                "--from",
+                "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_vod",
+                "mcp-server-vod",
+            ],
+            env=_vod_envs,
+        ),
+        timeout=float(os.getenv("TOOL_VOD_TIMEOUT", 10.0)),
+    )
+)