用途
Botverse MCP 是 Botverse 的 MCP 服务器与命令行工具,面向 AI 智能体以及配置它们的用户,用于在无需 AWS、FFmpeg 或自建基础设施的前提下完成视频转码与文档转换。
主要能力
- 视频转码:支持 MP4(H.264)、WebM(VP9)、ProRes 422、GIF,以及从视频中提取 MP3 音频。价格为 0.25 美元/任务。
- 视频/音频合成(conform):将独立的视频源与音频源混合为一个输出,协调帧率与时长不匹配(包括真正的 pulldown 式速度适配,例如 24→25fps)。价格为 0.30 美元/任务。
- 拼接(conform splice):将视频和/或静态图像片段连接为一个输出,例如片头板、片尾板、中插/切出镜头,或直接合并多个片段。价格从 0.30 美元/任务起。
- 文档转换:Markdown ↔ DOCX ↔ PDF ↔ HTML ↔ XLSX 互转。价格为 0.05 美元/文件。
- 转录:带说话人标注的转录(说话人分离 + AI 说话人命名),输出 txt/srt/vtt/docx/pdf。价格约 3 美元/小时。
- 工作流(Workflows):将多个 Botverse 操作(转码、转换、转录、合成、拼接)串联为一个多步骤任务,自动处理依赖顺序与并行分支,无需自行编排每次调用。仅转换类步骤按钱包余额计费(0.05 美元/步);转码/转录步骤按源时长计费,且需要开启自动充值。
使用方式
提供两种使用途径:面向 AI 智能体的 MCP 服务器,以及面向 shell 的 botverse CLI(适用于评估、CI/CD、cron、脚本和本地编码智能体)。
- 在 botverse.cloud 注册——可免费试用:注册赠送 1 美元额度,无需信用卡。仅在首次充值时(最低 5 美元)需要信用卡 + 2FA。无月费。
- 从仪表盘获取 API 密钥或连接器 URL。
- 添加到 MCP 客户端配置(Claude Desktop / Cursor / Windsurf),或使用连接器 URL(推荐用于 claude.ai)。
安装命令:npx -y botverse-mcp
命令行(botverse):同一软件包附带 botverse CLI,它从磁盘读取文件并直接流式传输到 API(内容不经过 LLM),因此是评估、自动化和本地编码智能体的快速路径。每个任务会执行上传 → 轮询 → 下载完成文件到 -o(默认:当前目录)。通配符和多个 --to 格式会作为批处理运行。
沙箱说明:CLI 需要到 botverse.cloud 及 Botverse 文件存储主机的出站网络,因此无法在出站被允许列表限制的沙箱化智能体环境(claude.ai / Claude Desktop)中运行。在这些环境中,请改用 MCP 工具(例如 convert_content)。
工作流(BWDL)
submit_workflow 将多个 Botverse 工具(转码、转换、转录、合成、拼接)串联为一个服务器端任务,例如转录 → 片段提取 → 交付,而不是让智能体逐个调用并轮询。
工作流定义使用 BWDL(Botverse Workflow Definition Language):一个包含 workflow_id 和 steps 数组的 JSON 对象。每个步骤有 id、tool(任意 MCP 工具名)、inputs 对象,以及可选的 depends_on(前置步骤 id 数组)。
- 步骤按依赖顺序运行;共享相同
depends_on的步骤并行运行。 - 后续步骤可用
"$.steps.<step_id>.output_key"引用前一步骤的输出,用"$.params.<name>"引用工作流级参数——不支持其他模板语法。 - 使用
submit_workflow提交,用get_workflow_status每 5–10 秒轮询一次,直到状态为 COMPLETED、FAILED、PARTIALLY_FAILED 或 CANCELLED;必要时可用cancel_workflow提前停止(仅对已完成的步骤计费)。 - 计费:仅转换类工作流按钱包余额计费,0.05 美元/步。包含转码或转录步骤的工作流需要开启自动充值(计费随源时长变化)。
示例——两步转换链(URL → DOCX → PDF):资料中未提供完整示例代码。
价格
- 视频转码(≤5 分钟):0.25 美元/任务
- 视频超时:+0.08 美元/分钟
- ProRes 422:0.35 美元/源分钟(最低 0.50 美元)
- 文档转换:0.05 美元/文件
- 额度永不过期。
适用场景与限制
适用于需要为 AI 智能体提供视频转码、文档转换、转录与媒体拼接能力,且不希望自行搭建 AWS 或 FFmpeg 基础设施的场景。限制包括:CLI 无法在出站受限的沙箱环境中运行;包含转码或转录步骤的工作流需开启自动充值;工作流模板语法仅支持上述两种引用形式。