关于 uploadcheck
UploadCheck 面向 Agent、制作流水线和编辑人员提供媒体质量检查。它为视频和音频文件返回 PASS、WATCH 或 BLOCK 结果,并提供带时间戳的问题及修复指引。
主要功能
- 01运行 40 多项媒体检查
- 02标记画面、音频、同步和文本问题
- 03返回带时间戳证据的判定结果
- 04生成编辑器标记 CSV 文件
- 05检查本地文件和视频 URL
适用场景
- 01发布前检查渲染后的视频
- 02查找播客中的音频中断
- 03定位短视频中被裁切的字幕
- 04将问题时间戳导入剪辑时间线
MCP 相关
MCP 服务提供估算和运行检查、获取任务状态与报告,以及生成剪辑器标记 CSV 等产物的工具。它使用托管的 UploadCheck API,检查在服务端运行。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @drantoniou/uploadcheck-mcpUPLOADCHECK_API_BASE_URLUploadCheck API base URLUPLOADCHECK_API_KEY密钥Workspace API key from your UploadCheck setup email (get one at https://uploadcheck.app/checkout/)本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
9收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| checks | string | 否 | |
| minutes | number | 否 | |
| plan_id | string | 否 | |
| profile | string | 否 | |
| cost_guardrail | enum | 否 | downgrade | block | off |
| duration_seconds | number | 否 | |
| included_minutes | number | 否 | |
| plan_price_cents | number | 否 | |
| ai_review_seconds | number | 否 |
详细介绍
🎬 UploadCheck MCP
你的 AI 与“发布”之间的质量门槛
你的 Agent 可以生成视频,却无法发现音频在 0:08 处中断、拼接处画面冻结,或字幕被裁切。UploadCheck 可以——并会返回需要修复的精确时间戳。
适用于任何会生成并交付给真实用户的媒体的 Agent、流水线或编辑器——AI 视频流水线、Shorts/Reels、播客、客户交付内容。
问题所在
能编写代码的 Agent 可以运行测试。能渲染视频的 Agent 却不知道视频是否有问题。
于是有问题的成片就这样发布了:旁白该出现时却一片寂静,两段片段拼接处画面冻结,口型与音频不同步,字幕被平台 UI 裁切,响度严重偏离目标。直到有人在评论里指出问题。
**UploadCheck 是你的 Agent 发布前调用的检查工具。**将成片交给它,它会返回 PASS、WATCH 或 BLOCK,并提供每个标记问题的时间戳和可供机器执行的修复建议——这样 Agent 只需修复被标记的片段并重新检查,而不必猜测或直接发布。
安装
npx -y @drantoniou/uploadcheck-mcp
Claude Code
claude mcp add --env UPLOADCHECK_API_BASE_URL=https://api.uploadcheck.app \
--env UPLOADCHECK_API_KEY=YOUR_KEY \
--transport stdio --scope user uploadcheck -- npx -y @drantoniou/uploadcheck-mcp
Cursor / Claude Desktop(mcp.json)
{
"mcpServers": {
"uploadcheck": {
"command": "npx",
"args": ["-y", "@drantoniou/uploadcheck-mcp"],
"env": {
"UPLOADCHECK_API_BASE_URL": "https://api.uploadcheck.app",
"UPLOADCHECK_API_KEY": "YOUR_KEY"
}
}
}
}
Codex
codex mcp add uploadcheck \
--env UPLOADCHECK_API_BASE_URL=https://api.uploadcheck.app \
--env UPLOADCHECK_API_KEY=YOUR_KEY \
-- npx -y @drantoniou/uploadcheck-mcp
在 uploadcheck.app 免费获取密钥——每月可用 200 分钟检查 40 多项指标,无需银行卡。
mcp-install.json 中提供了适用于所有客户端的机器可读安装片段。
**请妥善保管密钥。**它是与你套餐分钟数绑定的机密持有者令牌。请将它放入个人 MCP 配置中——绝不要放在已提交的文件、共享提示词或报告里。
使用方法
安装后,只需这样询问:
check ./final-cut.mp4 before I upload
Agent 会调用 qc_run_local_file,轮询 qc_get_job,然后读取 qc_get_report,并向你展示带时间戳的问题标记。
检查内容
每次检查都会运行 40 多项自动化检测,包括:
| 画面 | 画面冻结/循环、黑帧、画布适配与两侧黑边、时间扭曲、闪烁、隔行扫描梳齿效应 |
| 音频 | 静音、削波、响度(LUFS)与真峰值、响度范围、声道平衡、电源交流声、音频中断 |
| 同步与文字 | 口型/音频不同步、字幕安全区、文字对比度、文字被裁切或重叠 |
| 交付 | 分辨率/编码格式/帧率规格、Shorts/Reels 格式 |
付费套餐还可使用 AI“预言机”检测项——语音乱码、AI 人群中的人脸重复、旁白匹配度。
它不会告诉你片段是否由 AI 生成。它默认片段可能由 AI 生成,并检查其是否达到可发布的质量。
工具
| 工具 | 功能 |
|---|---|
qc_estimate_cost | 运行前估算检查分钟数和生效的门禁 |
qc_run_local_file | 检查本地导出文件(读取文件并将其发送到托管 API) |
qc_run_video | 检查 YouTube URL、签名 URL、上传 ID 或 base64 负载 |
qc_get_job | 轮询状态、进度、判定结果和计量分钟数 |
qc_get_report | 已完成的报告:判定结果 + 带时间戳的标记 + 证据 |
qc_get_events | 生命周期事件,方便 Agent 说明运行了哪些内容 |
qc_get_artifacts | 列出生成的报告产物 |
qc_get_marker_csv | 编辑器标记 CSV(可将标记直接放入 NLE 时间线) |
qc_create_upload_url | 为较大的文件创建签名上传 URL |
当 Agent 可能会重试同一素材时,将 idempotency_key 传给 qc_run_video——API 会返回现有任务,而不是重复运行。
如果你知道媒体类型,但不想手动选择门禁,请使用 profile:auto、shorts、audio、thumbnail、generic_creator_video,以及 youtube_shorts、podcast_delivery、broadcast_r128、ai_render_gate 等命名交付目标。显式指定的 checks 始终优先生效。
环境
export UPLOADCHECK_API_BASE_URL="https://api.uploadcheck.app"
export UPLOADCHECK_API_KEY="<workspace_api_key>"
此软件包是一个精简的 MCP 客户端,用于调用托管的 UploadCheck API——检查在服务端运行,而不是在你的设备上运行。较小和中等大小的本地文件可以直接以内嵌形式(base64)发送,无需持久化存储;较大的文件请使用签名上传 URL。
链接
- 网站和免费密钥 — uploadcheck.app
- 文档(API + MCP + 完整门禁参考) — uploadcheck.app/docs
- 签名 PASS/BLOCK 凭证 — uploadcheck.app/docs/receipts
许可证
MIT — 参见 LICENSE。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。