# 火山引擎视频点播

通过 MCP 裁剪、拼接视频，添加字幕并处理媒资。

- 类型：MCP
- 权限：可执行操作
- 门槛：需授权账号、需 API Key
- 官方入口：https://docs.volcengine.com/docs/video_on_demand/VODMCPAccessGuide
- 官方仓库：https://github.com/volcengine/mcp-server/tree/main/server/mcp_server_vod
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/volcengine-vod/

仅供参考，官方身份核验不代表接入实测；以厂商文档为准，密钥和登录在本地完成。修改或发送前须告知用户。

## 接入前准备

需要火山引擎实名认证账号、访问密钥、已开通的视频点播服务和点播空间；本地运行需 uvx。视频处理、存储及流量可能产生费用。

## 接入步骤

1. 开通视频点播并创建空间，获取火山引擎 Access Key 和 Secret Key。 [官方入口](https://docs.volcengine.com/docs/video_on_demand/VODMCPAccessGuide)
2. 按官方本地模式配置 uvx、密钥及空间名称；edit 分组提供剪辑工具。 [官方入口](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_vod/README_zh.md)

## 验证方法

连接客户端后先检查工具列表包含 audio_video_clipping；处理素材前确认权限和费用。

指引核对于 2026-11-05，不是本项目实测结果。

## 费用

MCP 开源工具及协议层不额外收费；视频点播的存储、云剪辑、其他处理和流量按资源使用计费。云端部署还涉及 API 网关和函数服务费用。 [官方来源](https://docs.volcengine.com/docs/video-on-demand/vod-mcp-integration-guide?lang=zh)（核对日期：2026-11-05）

官方原文：根据输出视频的分辨率和时长计费

## 安装配置

### JSON

```
{
  "mcpServers": {
    "volcengine-vod": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/volcengine/mcp-server.git#subdirectory=server/mcp_server_vod",
        "mcp-server-vod"
      ],
      "env": {
        "VOLCENGINE_ACCESS_KEY": "${VOLCENGINE_ACCESS_KEY}",
        "VOLCENGINE_SECRET_KEY": "${VOLCENGINE_SECRET_KEY}",
        "MCP_TOOLS_TYPE": "groups",
        "MCP_TOOLS_SOURCE": "edit,video_play,media_tasks",
        "MCP_SPACE_NAME": "${MCP_SPACE_NAME}"
      }
    }
  }
}
```

### Claude Code

```
claude mcp add --env 'VOLCENGINE_ACCESS_KEY=${VOLCENGINE_ACCESS_KEY}' --env 'VOLCENGINE_SECRET_KEY=${VOLCENGINE_SECRET_KEY}' --env 'MCP_TOOLS_TYPE=groups' --env 'MCP_TOOLS_SOURCE=edit,video_play,media_tasks' --env 'MCP_SPACE_NAME=${MCP_SPACE_NAME}' --transport stdio 'volcengine-vod' -- 'uvx' '--from' 'git+https://github.com/volcengine/mcp-server.git#subdirectory=server/mcp_server_vod' 'mcp-server-vod'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.volcengine-vod]
command = "uvx"
args = ["--from","git+https://github.com/volcengine/mcp-server.git#subdirectory=server/mcp_server_vod","mcp-server-vod"]
env_vars = ["VOLCENGINE_ACCESS_KEY","VOLCENGINE_SECRET_KEY","MCP_SPACE_NAME"]

[mcp_servers.volcengine-vod.env]
MCP_TOOLS_TYPE = "groups"
MCP_TOOLS_SOURCE = "edit,video_play,media_tasks"
```

JSON 示例用于 Claude Code 的 .mcp.json；${VAR} 从启动客户端的环境读取。Codex 的环境变量也须在启动进程中可用，不能将变量名替换成密钥值。

命令会进入 shell 历史，请在本地执行，不要分享。保留命令中的 ${VAR} 引用；Codex 不支持在 URL 或命令参数中展开这些引用，此处保留待本地处理的占位符。

## 核验与来源

2026-11-05 核对官方身份：[依据](https://github.com/volcengine/mcp-server/blob/main/server/mcp_server_vod/README_zh.md)。火山引擎官方仓库与接入指南均列出 VOD MCP 视频剪辑工具及本地接入配置。

官方原文摘录（2026-11-05，来自上述依据）：

```
多片段拼接
```

- [火山引擎官方接入指南](https://docs.volcengine.com/docs/video_on_demand/VODMCPAccessGuide)

[使用说明与免责声明](https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer)
