crabcut-mcp-server

CrabCut MCP Server 是一个 MCP（Model Context Protocol）服务器，用于将 YouTube 视频转化为短视频片段。它可以从 Claude、Cursor 或任何支持 MCP 的 AI 助手中调用。

用途

用户提供一个 YouTube 链接，服务会自动寻找视频中的最佳时刻，将其重构为竖屏视频（9:16），添加字幕，并返回可下载的片段。

主要能力

• 精彩片段检测：自动识别视频中的高光时刻。
• 竖屏重构：将横屏视频调整为 9:16 竖屏格式。
• 字幕添加：为片段生成字幕。
• 下载就绪：返回每个片段的 download_url，可直接下载。
• 片段排序：返回的片段按评分从高到低排序。

使用方式

获取 API 密钥

在 app.crabcut.ai/developers 获取 API 密钥。

在 Claude Desktop / Cursor 中配置

将服务器添加到配置文件：Claude 使用 claude_desktop_config.json，Cursor 使用 .cursor/mcp.json。

远程接入（Streamable HTTP）

适用于 n8n、自定义集成或任何支持远程 MCP 的客户端：

• 端点：https://mcp.crabcut.ai/mcp
• 认证：Authorization: Bearer sk_live_...
• 传输：Streamable HTTP (POST)

调用流程

1. 使用 YouTube URL 调用 generate_clips。
2. 立即返回 project_id。
3. 每 10–15 秒轮询 get_project_status（或传入 callback_url 使用 webhook）。
4. 完成后，片段按评分排序（最佳优先），每个片段带有 download_url。

项目状态

pending → processing → completed（或 completed_no_clips / failed）

处理步骤

queued → DOWNLOADING_VIDEO → EXTRACTING_AUDIO → TRANSCRIBING → DETECTING_HIGHLIGHTS → CUTTING_CLIPS → EXPORTING_CLIPS → done

片段状态

pending → exporting → completed（或 failed）。当 clip_status 为 completed 时，download_url 可用。

工具说明

generate_clips：从 YouTube 视频开始生成片段。 get_project_status：检查进度并获取片段。片段按评分从高到低排序。

Webhook 回调

调用 generate_clips 时传入 callback_url，当所有片段就绪时会收到 POST 通知。片段按评分从高到低排序。如果服务器未响应，最多重试 3 次。 签名验证（可选）：每个回调包含 X-Crabcut-Signature 头。使用 SHA-256(your_api_key) 作为签名密钥，对请求体计算 HMAC-SHA256，与头值（sha256=<hex>）比较。

n8n 集成示例

方式 A — Webhook（推荐）：

1. 创建带 Webhook 触发节点的工作流，复制其 URL。
2. 添加 HTTP Request 节点：POST https://api.crabcut.ai/api/v1/clips/generate，使用 Header Auth（Authorization: Bearer sk_live_...），请求体：{ "url": "https://www.youtube.com/watch?v=...", "callback_url": "https://your-n8n.com/webhook/abc123" }
3. 片段就绪时，Webhook 节点接收负载。 最佳片段：{{ $json.clips[0].download_url }}

方式 B — 轮询循环：

1. POST 生成片段（同上，不带 callback_url）。
2. 等待 15 秒 → GET https://api.crabcut.ai/api/v1/projects/{{ $json.project_id }} → 如果状态不是 completed，则循环回等待。

直接 HTTP 调用（不使用 MCP）

基础 URL：https://api.crabcut.ai — 所有端点需要 Authorization: Bearer sk_live_...

适用场景

• 内容创作者将长视频快速剪辑为短视频。
• 社交媒体运营批量生成竖屏片段。
• 通过 n8n 等自动化工具集成到工作流中。

限制

• 需要 API 密钥，具体定价信息请参考 crabcut.ai/pricing。
• 仅支持 YouTube 视频作为输入。
• 处理时间取决于视频长度和服务器负载。

环境变量

资料中未提供具体环境变量列表。

相关链接

• 网站：crabcut.ai
• API 密钥：app.crabcut.ai/developers
• 定价：crabcut.ai/pricing