内容
# botverse-mcp
Botverse 的 MCP 服务器及命令行工具 —— 为 AI 代理及其配置人员提供视频转码和文档转换服务。
[](https://www.npmjs.com/package/botverse-mcp)
## 功能介绍
- **视频转码** —— MP4 (H.264)、WebM (VP9)、ProRes 422、GIF、MP3 提取，费用：$0.25/任务
- **文档转换** —— Markdown ↔ DOCX ↔ PDF ↔ HTML ↔ XLSX，费用：$0.05/文件
- **语音转文本** —— 带说话者标签的转录文本（说话者识别 + AI 自动命名）→ txt/srt/vtt/docx/pdf，费用：约 $5/小时
使用方式有两种：为 AI 代理提供 MCP 服务器，以及为 Shell 提供 `botverse` 命令行工具 —— 适用于评估、CI/CD、cron、脚本和本地编码代理。无需 AWS，无需 FFmpeg，无需基础设施。
## 设置
1. 在 [botverse.cloud](https://botverse.cloud) 注册 —— **免费试用：注册赠送 $1 积分，无需绑定信用卡**。仅在首次充值（最低 $5）时需要绑定信用卡和启用两步验证。无月费。
2. 在仪表盘中获取 API 密钥或连接器 URL
3. 将其添加到 MCP 客户端配置中
## 使用
### Claude Desktop / Cursor / Windsurf
```json
{
"mcpServers": {
"botverse": {
"command": "npx",
"args": ["-y", "botverse-mcp"],
"env": {
"BOTVERSE_API_KEY": "bv_live_..."
}
}
}
}
```
或使用连接器 URL（推荐用于 claude.ai）：
```json
{
"mcpServers": {
"botverse": {
"command": "npx",
"args": ["-y", "botverse-mcp"],
"env": {
"BOTVERSE_CONNECTOR_URL": "https://botverse.cloud/mcp?token=bv_sess_..."
}
}
}
}
```
## 命令行 (`botverse`)
同一软件包提供了一个 `botverse` 命令行工具，可在 Shell 中使用 —— 它直接从磁盘读取文件并将其流式传输到 API（内容不会经过 LLM），因此它是评估、自动化和本地编码代理的快速通道。
```bash
export BOTVERSE_API_KEY=bv_live_… # 或 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 balance
```
每个任务都会上传 → 轮询 → 下载完成的 文件到 `-o`（默认：当前目录）。 glob 和多个 `--to` 格式作为批处理运行。
> **沙盒注意：** CLI 需要访问 `botverse.cloud` 和 S3 的外网，因此 **无法** 在沙盒代理环境（claude.ai / Claude Desktop）中运行，因为其出口是允许列出的。在这些环境中，请使用 MCP 工具（`convert_content` / `get_output_content`）。
## 工具（MCP）
| 工具 | 描述 |
|---|---|
| `transcode_from_url` | 从公开 URL 转码视频 |
| `transcode_video` | 转码上传的视频文件 |
| `convert_content` | 内联转换文档内容（最大 4 MB；沙盒安全） |
| `convert_from_url` | 从公开 URL 转换文档 |
| `convert_file` | 转换上传的文档 |
| `get_job_status` | 轮询任务直到完成 |
| `get_download_url` | 获取签名的下载 URL |
| `get_output_content` | 获取已完成输出的字节内联（沙盒安全下载） |
| `get_wallet_balance` | 检查钱包余额 |
## 定价
- 视频转码（≤5 分钟）：**$0.25/任务**
- 视频超出部分：**+$0.08/分钟**
- ProRes 422：**$0.50/任务**
- 文档转换：**$0.05/文件**
积分永不过期。[完整定价 →](https://botverse.cloud/pricing)
## 链接
- [文档](https://botverse.cloud/docs)
- [仪表盘](https://botverse.cloud/dashboard)
- [支持](mailto:support@botverse.cloud)
