口播视频自动剪辑 MCP

cool.qianshiPublished by qianshi.coolOfficial publisherv1.2.0Updated Oct 29, 2026

输入口播文案与素材，自动生成安全排版出片计划并云端渲染成片。前 3 条免费。

VerifiedStreamable HTTPWeb executableMedia & DesignAI & ML

Overview

AI-generated overview

Cloud MCP for talking-head videos: plans a safe layout from your script and footage, then renders the finished clip and returns its URL.

What you can do
  • Generate a recut plan from talking-head video metadata and script, covering face-safe zones, MG card placement and BGM mood matching, without rendering.
  • Submit a render job from that plan and receive a job ID.
  • Poll a job to check render status and get the finished video URL.
When to use it
Useful when you produce talking-head or knowledge-creator videos and want an assistant to lay out captions, cards and music safely around the speaker's face, then render the result in the cloud instead of setting up a local render pipeline.
Requirements
Remote Streamable HTTP endpoint; the README states an API key issued by the platform, sent as an Authorization Bearer header (for example via a TH_RECUT_API_KEY variable), is required for MCP access. Network access to the provider's service.
Before you install
Rendering is billed per video after the first three free ones (¥2.90 each, paid to the creator), and the MCP key shares the same quota and billing as the paid SkillHub route. Your footage and script are sent to the provider's cloud for planning and rendering. The free local QC scripts in the linked repository are separate and not part of this endpoint.

Installation

In SourceWeft

  1. Open 口播视频自动剪辑 MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/cool.qianshi%2Fth-recut-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "cool-qianshi-th-recut-jrbr": {
      "type": "http",
      "url": "https://www.qianshi.cool/thapi/mcp"
    }
  }
}

README

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

[GitHub stars] [MCP Registry] [Glama] [License] [线上体验页]

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

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

我想…点这里
先看看效果、别装环境线上体验页
下载离线跑Releases v1.0.0
直接出片（不想自搭渲染）SkillHub · 前 3 条免费
接进 Claude Code / CursorMCP 端点（见下方配置）
商用 / 企业批量联系我们

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

它解决什么

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

适用谁

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

环境要求

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

快速开始

bash
# 一次性体检（推荐入口）python scripts/doctor.py --video your.mp4python 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 # 智能断句

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

检查项清单

脚本检查什么关键输入
doctor.py一次性体检汇总（构图 + 音频）--video
detect_faces.py人脸禁区 / 显示画幅安全区探测--video
check_card_layout.py卡片矩形是否遮挡人脸禁区禁区 zones + 卡片 JSON
check_pip.py / check_pip_audio.py / check_pip_coverage.pyPIP 落位 / 声音 / 覆盖验收成片 + 计划 JSON
audio_qc.py削波 / 增益 / 时序成片 --out + 原始 --src
audio_band_check.py音频频段分布检查音频 + 参考
check_audio_caption_sync.py音频与字幕同步音频 + 字幕 JSON
split_sentences.py智能断句（词边界不切断）ChatCut tokens JSON
clean_fillers.py气口 / 口头禅清理建议文本 + 时间轴
make_pip_source.py人脸中心正方形裁切源生成源视频
measure_zoom.py缩放测量序列帧

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

输出什么（样例）

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

检查项结果说明
人脸禁区 / 显示画幅✅ PASS探测到 2 个显示画幅安全区
音频验收（削波/增益/时序）✅ PASS无削波

免费 vs 付费

本地体检（本仓库，免费）云端出片（SkillHub Pay Skill）
人脸禁区 / 断句 / 构图 / 音画✅ 查出来✅ 查出来并自动避让布点
产出"编辑剧本"✅ 预览✅ 预览 + 渲染成片
出片渲染❌ 需自备剪辑工具✅ 前 3 条免费，之后 ¥2.90/条

👉 一键直达云端出片

[直达云端出片]

云端出片（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）：

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）或联系作者 （[email protected] / 千视科技（深圳）有限公司）。

联系

场景渠道
个人使用 / 试用直接用，无需联系
商用 / 批量出片SkillHub 云端出片（¥2.90/条，前 3 条免费）
企业定制 / 私有部署 / 批量授权[email protected]（千视科技（深圳）有限公司）
功能建议 / 报错开 Issue

合规与边界

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

Source: README.md at commit 19b3b3c

Tools

3

generate_recut_plan

根据口播视频元信息与文案，生成出片计划（人脸禁区安全布局 / MG 卡片反选 / BGM 情绪匹配），不渲染。

Parameterscopyrequiredslugthemevideorequiredzones

render_recut_video

提交渲染任务，返回 job_id；用 get_recut_job 轮询成片。

Parameterscopyplanslugvideomedia_urlrequired

get_recut_job

查询渲染任务状态与成片 URL。

Parametersjob_idrequired

Version history

2
  1. v1.2.0LatestOct 29, 2026
  2. v1.0.0Oct 22, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Qianshi integrations

Hypermarrow Mcp

Published by GitHub account qianqiuwanzi

A local-first AI memory server that lets an assistant record, recall and consolidate long-term context stored on your own machine.

STDIODesktop only
Files & StorageNot validated yetOct 24, 2026