Th Recut Free MCP Server

th-recut-free · 口播视频本地体检

你录完口播视频，最烦的是不是：脸跑到画面边缘、字幕断句怪、卡片挡脸、音画不同步？ 这个开源工具帮你在本地把这些坑一次性查出来——视频素材不出本机，永久免费。

👉 不想自己搭渲染环境？直接云端出片（前 3 条免费、不水印） ｜ 在线体验页 → https://qianqiuwanzi.github.io/th-recut-free/

⭐ 如果这套体检脚本帮你省了时间，给个 star——它会让我知道该往哪加功能。

它解决什么

口播视频的"排版包装"里，最重复、最吃人力的不是"剪"，是排版前的质检： 人脸有没有越界、字幕断得合不合理、卡片会不会挡脸、音画对不对得上。 th-recut-free 把这几件事做成可本地运行的脚本，跑完给你一份清单。

适用谁

• 口播创作者 / 知识博主，日更或周更，自己剪或外包剪都行
• 想先"免费看质量"再决定要不要花钱出片的人

环境要求

• Python 3.8+
• ffmpeg（需在 PATH 中，脚本经它解码音视频）
• 可选依赖：pip install -r requirements.txt（numpy / opencv / jieba，按脚本需要安装； 缺依赖时相关脚本会给出提示，其余脚本不受影响）

快速开始

# 一次性体检（推荐入口）
python scripts/doctor.py --video your.mp4
python scripts/doctor.py --video your.mp4 --src raw.mp4   # 有原始素材时附带增益/时序对比

# 或按需单独跑
python scripts/detect_faces.py --video your.mp4                       # 人脸禁区 / 显示画幅探测
python scripts/audio_qc.py --out your.mp4 --src raw.mp4               # 音频验收（削波/增益/时序）
python scripts/split_sentences.py --tokens tokens.json --out seg.json # 智能断句

不需要账号、不需要联网、视频不出本机。

检查项清单

每个脚本 --help 可看完整参数；输出为 JSON 或人读报告，含 verdict: PASS/FAIL。

输出什么（样例）

doctor.py 跑完会得到一张表，类似：

免费 vs 付费

👉 一键直达云端出片

云端出片（Pay Skill） → https://www.qianshi.cool/skillpay/go?src=github&to=skillhub

• 装上就能用：SkillHub 上「口播视频自动剪辑」，评分 4.6，创作者为千视科技（深圳）有限公司
• 前 3 条完整出片免费、不水印；超出 ¥2.90/条（微信支付，费用直接付给创作者）
• 和本仓库的关系：本仓库是免费的本地体检层，云端是渲染层。体检结果直接喂给云端出片，不用重跑
• 不想装 SkillHub？用下面的 MCP 端点直接接进 Claude Code / Cursor / Cline

两条付费入口同源（同一个收款主体、同一个计费口径），额度也共享。

云端 MCP（给开发者 / 智能体）

除了在 SkillHub 对话里用，云端出片能力也开放为标准 MCP（Model Context Protocol） 服务， 任何支持自定义 MCP 的客户端（Claude Code / Cursor / Cline / Glama 等）都能直接调用：

• 端点：https://www.qianshi.cool/thapi/mcp（Streamable HTTP + JSON-RPC 2.0）
• 鉴权：Authorization: Bearer <平台颁发的 API Key>
• 3 个工具：generate_recut_plan（生成安全排版出片计划）→ render_recut_video（提交渲染） → get_recut_job（轮询拿成片）

连接示例（Claude Code / Cursor 的 .mcp.json）：

{
  "mcpServers": {
    "th-recut": {
      "type": "http",
      "url": "https://www.qianshi.cool/thapi/mcp",
      "headers": { "Authorization": "Bearer ${TH_RECUT_API_KEY}" }
    }
  }
}

MCP 接入需平台颁发的 API Key（按次计费，前 3 条免费），与 SkillHub 付费链路同源。

FAQ

Q：视频会上传吗？ 不会。所有脚本只读你本地文件，经本机 ffmpeg 解码，无任何网络请求。

Q：为什么某些脚本要 numpy / opencv / jieba？ 频谱与画面分析用 numpy / opencv，中文分词用 jieba。都是可选依赖， 装了功能完整，不装则相关脚本不可用，其余脚本照常。

Q：能直接帮我剪好/出片吗？ 本仓库只做"体检"和"预览"。要成片，点这里直接用云端出片： https://www.qianshi.cool/skillpay/go?src=github&to=skillhub（前 3 条免费）， 或自备剪辑工具按体检报告手工处理。

Q：可以商用吗？ 本仓库以 CC BY-NC 4.0 发布，禁止商用。商用请走云端出片付费链路 （https://www.qianshi.cool/skillpay/go?src=github&to=skillhub）或联系作者 （105920869@qq.com / 千视科技（深圳）有限公司）。

联系

合规与边界

• 本仓库仅含本地质检脚本，不含任何服务端 / 计费 / 渲染组件。
• 渲染依赖你自备的剪辑工具（如 ChatCut），本工具不代管任何第三方账号凭证。
• 许可：CC BY-NC 4.0（禁止商用，如需商用请联系作者）。