← 返回目录
C

ClipForge MCP Server

社区
用一句话或一个商品链接,从任意 MCP 客户端驱动 ClipForge 的免 Key 短视频流水线,产出一条成品竖屏视频。
GitHub 源仓库 ↗
★ 756 Stars 分类 · 其他 非常热门
58FMRS · C

ClipForge MCP Server 是一个社区维护的开源 MCP 接入层,它把 ClipForge 的免 Key 短视频流水线(脚本 → 免费素材 → 免费 TTS → 字幕 → BGM → FFmpeg 合成)开放给任意 MCP 客户端。免 Key 即可出片,配 LLM 后可生成脚本;自部署、无水印、AGPL-3.0。适合想本地自动化产出带货竖屏视频并让 AI 助手直接驱动的用户,不适合需要官方支持或不愿在本地运行实例与 FFmpeg 的场景。

可靠性
9/20
安全与权限
10/20
维护活跃度
14/20
文档质量
13/20
安装易用性
12/20
查看 FMRS 评分方法 →

ClipForge(原名「带货剪手」/ daihuo-jianshou)是一个开源的 AI 带货/UGC 短视频生成项目:上传一张商品图,自动提炼卖点、撰写种草脚本、保持商品原图不变形,并配上画面、配音与字幕,一键产出适配抖音小店、快手、小红书、视频号与 TikTok Shop 的竖屏卖货短视频;也支持「一句话主题成片」。其 MCP Server(npm 包 clipforge-mcp,版本 0.1.4)通过 stdio 传输,把这条流水线(脚本 → 免费素材 → 免费 TTS → 字幕 → BGM → FFmpeg 合成)暴露给任意 MCP 客户端。素材与配音在无 LLM 配置时也可免 Key 运行,脚本生成则需要 OpenAI 兼容的 LLM 端点。项目以 AGPL-3.0 授权,自部署运行,数据保存在本机。该 MCP Server 由项目作者维护,属于社区开源项目,并非任何平台或模型厂商的官方服务。

工具能力

create_video
一句话或商品链接直接创建一条短视频,支持 wait:false 非阻塞提交以避免客户端超时。
compose
在已就绪的素材与脚本基础上执行 FFmpeg 合成,输出最终成片,支持 wait:false 非阻塞提交。
clipforge_update_shots
针对单个分镜做单句精修,配合质量闸门/QC 反馈定点修改,无需整篇重新生成。
clipforge_product_script
贴入商品链接,直接产出带货脚本。

安装接入

  1. 先启动一个 ClipForge 实例:可用 Docker 运行 docker run -d -p 3000:3000 -v clipforge-data:/data ghcr.io/xixihhhh/clipforge,或在仓库内用 pnpm dev / pnpm start 启本地服务。
  2. 在 MCP 客户端配置中加入 clipforge-mcp:命令 npx,参数 -y [email protected],传输方式为 stdio。
  3. 按需设置环境变量:CLIPFORGE_BASE_URL 指向运行中的实例(默认 http://localhost:3000);如要让 AI 写脚本,再设置 CLIPFORGE_LLM_BASE_URL / CLIPFORGE_LLM_API_KEY / CLIPFORGE_LLM_MODEL(OpenAI 兼容端点)。
  4. 重载客户端,确认 MCP Server 已连接后即可调用工具出片。
claude_desktop_config.json
{
  "mcpServers": {
    "clipforge": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "CLIPFORGE_BASE_URL": "http://localhost:3000",
        "CLIPFORGE_LLM_BASE_URL": "",
        "CLIPFORGE_LLM_API_KEY": "",
        "CLIPFORGE_LLM_MODEL": ""
      }
    }
  }
}

选型与风险

适合谁

  • 需要本地自部署、无水印、数据不出本机的短视频生产团队
  • 希望让 AI 助手(如 Claude Desktop、Cursor)直接驱动出片流水线的开发者
  • 做电商带货、UGC 广告或 faceless 竖屏内容的运营者
  • 想在 0 Key 前提下先用免费素材与免费 TTS 跑通流程的个人用户

不适合谁

  • 需要官方商业支持或 SLA 保障的企业生产环境
  • 期望完全免 Key 就能获得高质量 AI 生成画面与原生人声的用户
  • 不希望在本机运行 FFmpeg、Node 或 Docker 环境的用户
  • 要求服务端托管、无需本地实例的纯云用户

所需权限

  • 通过 stdio 在本地启动 npx 进程(clipforge-mcp)
  • 读取环境变量 CLIPFORGE_BASE_URL、CLIPFORGE_LLM_BASE_URL、CLIPFORGE_LLM_API_KEY(敏感)、CLIPFORGE_LLM_MODEL
  • 访问本机运行的 ClipForge 服务 HTTP 接口(默认 http://localhost:3000)
  • 当配置了 LLM 端点时,向该端点发起网络请求以生成脚本
  • 在 ClipForge 实例端使用 FFmpeg 进行本地视频合成并读写本地数据文件

风险与副作用

  • CLIPFORGE_LLM_API_KEY 为敏感凭据,泄露会导致第三方模型调用被他人消耗
  • 配置了外部 LLM 端点或付费 AI 模型时,脚本与素材相关调用可能产生按量费用,付费生成不可静默触发
  • AI 生成内容在国内平台有合规要求(AIGC 标识、广告法违禁词),发布前需自行核对,项目默认开启相关标识与扫描但不代替合规责任
  • 免费素材来自第三方授权库(如 Openverse、Wikimedia、Jamendo 等),商用前需按其各自授权核实并保留署名
  • 本地实例若暴露到网络,可能被他人调用并消耗你的模型额度

常见排障

  1. 工具调用失败先确认 ClipForge 实例已启动且 CLIPFORGE_BASE_URL 可访问(默认 http://localhost:3000)
  2. 脚本生成报错时检查 CLIPFORGE_LLM_BASE_URL / API Key / 模型名是否正确;注意部分平台聊天接口路径与素材网关不同
  3. 出现客户端超时可在 compose / create_video 上使用 wait:false 改为非阻塞提交
  4. 合成为空或失败时检查本机是否安装 FFmpeg,以及素材是否成功下载并通过解码校验
  5. 生成质量不佳时用 clipforge_update_shots 做单分镜定点修复,而不是整篇重新生成

使用场景

在 MCP 客户端中用一句话主题直接生成一条竖屏短视频
贴入商品链接或上传商品图,自动生成带货口播/短剧类卖货视频
批量或定时(配合 cron)自动产出待发布草稿视频
把长文案导入后自动切分镜、配免费素材与免费配音并合成
为出海场景把脚本换语种重新配音后合成多语言版本

支持客户端

Claude Desktop完整支持
Cursor完整支持