botverse

botverse-mcp

面向 Botverse 的 MCP 服务和命令行工具——为 AI Agent 及配置它们的人提供视频转码和文档转换服务。

功能

• 视频转码——MP4（H.264）、WebM（VP9）、ProRes 422、GIF、提取 MP3 · $0.25/个任务
• 视频/音频匹配——将独立的视频和音频源混流为一个输出文件，并协调帧率和时长不匹配的问题（包括真正的 Pulldown 风格速度匹配，例如 24→25fps）· $0.30/个任务
• 匹配拼接——将视频和/或静态图像片段合并为一个输出文件：片头字幕/短片、片尾字幕/结束卡、中插内容/切出片段，或将片段接在一起 · 起价 $0.30/个任务
• 文档转换——Markdown ↔ DOCX ↔ PDF ↔ HTML ↔ XLSX · $0.05/个文件
• 转录——带说话人标签的转录文本（说话人分离 + AI 说话人命名）→ txt/srt/vtt/docx/pdf · 约 $3/小时
• 工作流——将多个 Botverse 操作（转码、转换、转录、匹配、拼接）串联为一个多步骤任务，自动安排依赖顺序并支持并行分支，无需自行编排每次调用 · 仅转换步骤使用钱包余额（$0.05/步）；转码/转录步骤按源文件时长计费，并要求启用自动充值

有两种使用方式：供 AI Agent 使用的MCP 服务，以及供 Shell 使用的 botverse CLI——适用于评估、CI/CD、cron、脚本和本地编码 Agent。无需 AWS。无需 FFmpeg。无需基础设施。

设置

1. 在 botverse.cloud 注册——**免费试用：注册即得 $1 额度，无需银行卡。**首次充值时才需要银行卡和 2FA（最低 $5）。无月费。
2. 从控制面板获取 API 密钥或连接器 URL
3. 添加到 MCP 客户端配置中

用法

Claude Desktop / Cursor / Windsurf

{
  "mcpServers": {
    "botverse": {
      "command": "npx",
      "args": ["-y", "botverse-mcp"],
      "env": {
        "BOTVERSE_API_KEY": "bv_live_..."
      }
    }
  }
}

或者使用连接器 URL（推荐用于 claude.ai）：

{
  "mcpServers": {
    "botverse": {
      "command": "npx",
      "args": ["-y", "botverse-mcp"],
      "env": {
        "BOTVERSE_CONNECTOR_URL": "https://botverse.cloud/mcp?token=bv_sess_..."
      }
    }
  }
}

命令行（botverse）

同一软件包还附带供 Shell 使用的 botverse CLI——它会从磁盘读取文件并直接将文件流式传输到 API（内容不会经过大模型），因此适合用于评估、自动化和本地编码 Agent。

export BOTVERSE_API_KEY=bv_live_…        # or BOTVERSE_CONNECTOR_URL=…?token=bv_sess_…

npx botverse convert report.md --to pdf
npx botverse convert *.md --to docx,pdf -o ./out
npx botverse transcode clip.mov --to mp4 -o ./out
npx botverse transcribe call.mp4 --to docx --attendees "Sarah Chen,Mike Torres"
npx botverse conform video.mp4 audio.wav --to mp4 --method speed_conform --target-framerate 25
npx botverse balance

每个任务都会上传文件、轮询状态，并将处理完成的文件下载到 -o 指定的位置（默认：当前目录）。 Glob 模式和多个 --to 格式会批量运行。

**沙箱说明：**CLI 需要能够向 botverse.cloud 和 Botverse 的文件存储主机发起出站网络连接，因此 无法在沙箱化的 Agent 环境中运行（claude.ai / Claude Desktop），这些环境会对出站连接进行允许列表限制。 在这类环境中，请改用 MCP 工具（例如 convert_content）。

工具（MCP）

工具	描述
get_upload_url	获取预签名 URL，以便上传文件供 _media/_file/_video（基于对象键）工具使用
transcode_from_url	转码来自公开 URL 的视频
transcode_video	转码已上传的视频文件
conform_from_url	将单独的视频和音频来源（公开 URL）混流为一个输出
conform_media	将已上传的视频和音频来源混流为一个输出
conform_splice_from_url	拼接视频/图像片段（公开 URL）——片头板、转场片头、片尾卡、插入片段、合并剪辑
conform_splice_media	拼接已上传的视频/图像片段——适用场景相同
convert_content	就地转换文档内容（最大 4 MB；可在沙盒中安全运行）
convert_from_url	转换来自公开 URL 的文档
convert_file	转换已上传的文档
submit_workflow	提交多步骤 BWDL 工作流，将上述多个工具串联起来，并支持依赖排序和并行分支
get_workflow_status	轮询工作流（及其各步骤状态），直到工作流进入终止状态
cancel_workflow	取消正在进行的工作流；已完成的步骤照常计费，其余步骤不收费
get_job_status	轮询任务，直到完成
get_download_url	获取签名下载 URL
get_wallet_balance	查看钱包余额

工作流

submit_workflow 会将多个 Botverse 工具（转码、转换、转录、合流、拼接）串联为一个服务端任务，例如转录 → 剪辑提取 → 交付，而不必让你的 Agent 逐个调用工具并分别轮询。

• 工作流定义使用 BWDL（Botverse 工作流定义语言）：一个包含 workflow_id 和 steps 数组的 JSON 对象。每个步骤包含 id、tool（任意 MCP 工具名称）、inputs 对象，以及可选的 depends_on 数组，用于指定先前步骤的 ID。
• 步骤按依赖顺序运行；共享相同 depends_on 的步骤会并行运行。
• 后续步骤可以使用 "$.steps.<step_id>.output_key" 引用先前步骤的输出，也可以使用 "$.params.<name>" 引用工作流级参数——不支持其他模板语法。
• 使用 submit_workflow 提交，每隔 5–10 秒使用 get_workflow_status 轮询，直到状态为 COMPLETED、FAILED、PARTIALLY_FAILED 或 CANCELLED；如有需要，可使用 cancel_workflow 提前停止（只需为已完成的步骤付费）。
• 计费：仅含转换步骤的工作流从钱包余额中扣款，每步 $0.05。包含转码或转录步骤的工作流要求启用自动充值（费用按源文件时长计算）。

示例——两步转换链（URL → DOCX → PDF）：

{
  "workflow_id": "md-to-pdf-via-docx",
  "steps": [
    {
      "id": "to_docx",
      "tool": "convert_from_url",
      "inputs": {
        "source_url": "https://example.com/report.md",
        "output_format": "docx"
      }
    },
    {
      "id": "to_pdf",
      "tool": "convert_file",
      "depends_on": ["to_docx"],
      "inputs": {
        "object_key": "$.steps.to_docx.output_key",
        "output_format": "pdf"
      }
    }
  ]
}

定价

• 视频转码（≤5 min）：$0.25/job
• 超出的视频时长：+$0.08/min
• ProRes 422：$0.35/source-min（最低 $0.50）
• 文档转换：$0.05/file

积分永不过期。完整定价 →

链接

• 文档
• 控制面板
• 支持