Ssemble AI Clipping

Ssemble MCP Server

适用于 Ssemble AI Clipping 的 MCP 服务 — 使用任意 AI 助手创建有望走红的短视频。

支持 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf 以及任何兼容 MCP 的客户端。

功能

此 MCP 服务可让 AI 助手使用 Ssemble 的 AI 剪辑引擎，从 YouTube 视频创建短视频剪辑。AI 可以：

• 创建短视频，来源可以是 YouTube URL 或上传的文件
• Webhook 回调 — 处理完成后接收通知（支持 n8n、Zapier、Make）
• 浏览素材 — 字幕模板、背景音乐、游戏画面叠加素材、迷因钩子
• 跟踪处理进度 — 查看进度并获取已完成的剪辑
• 管理请求 — 查看历史记录、获取结果、删除旧请求

前置条件

• Ssemble 账号，且订阅有效
• API 密钥（在 Ssemble 控制面板的 Settings → API Keys 中获取）
• Node.js >= 18

快速开始

Claude Desktop

编辑配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ssemble": {
      "command": "npx",
      "args": ["@ssemble/mcp-server"],
      "env": {
        "SSEMBLE_API_KEY": "sk_ssemble_your_key_here"
      }
    }
  }
}

保存后重启 Claude Desktop。

Claude Code

claude mcp add ssemble -- npx @ssemble/mcp-server

然后设置环境变量：

export SSEMBLE_API_KEY="sk_ssemble_your_key_here"

Cursor / VS Code / Windsurf

添加到 MCP 设置中：

{
  "mcpServers": {
    "ssemble": {
      "command": "npx",
      "args": ["@ssemble/mcp-server"],
      "env": {
        "SSEMBLE_API_KEY": "sk_ssemble_your_key_here"
      }
    }
  }
}

可用工具

工具	描述
create_short	从视频创建 AI 生成的短视频剪辑。立即返回请求 ID。
get_status	查看处理进度（0-100%）和当前步骤
get_shorts	获取已完成的剪辑，包括视频 URL、标题和传播分数
list_requests	使用分页和状态筛选列出所有请求
delete_request	永久删除请求及其视频
list_templates	浏览字幕样式模板
list_music	浏览背景音乐曲目
list_game_videos	浏览游戏画面叠加视频
list_meme_hooks	浏览迷因钩子吸睛片段

处理流程

视频处理需要 5-30 分钟。有两种工作流可选：

选项 A：轮询（手动检查）

1. create_short — 提交任务并立即返回请求 ID
2. get_status — 随时查看进度（排队中 → 处理中 → 已完成）
3. get_shorts — 完成后获取生成的剪辑

选项 B：Webhook（自动处理）

1. 使用 webhookUrl 调用 create_short — 提交任务并附上回调 URL
2. 处理完成或失败时，API 会向你的 URL 发送包含结果的 HTTP POST 请求
3. 无需轮询 — 非常适合 n8n、Zapier、Make 以及自定义后端集成

Webhook 载荷示例：

{
  "event": "shorts.completed",
  "requestId": "507f1f77bcf86cd799439011",
  "status": "completed",
  "timestamp": "2026-03-30T12:00:00.000Z",
  "data": {
    "shorts": [
      {
        "id": "...",
        "title": "AI-Generated Title",
        "video_url": "https://...",
        "duration": 45,
        "viral_score": 8.5
      }
    ]
  }
}

使用示例

从 YouTube 视频创建短视频：

“从 https://youtube.com/watch?v=abc123 创建短视频，使用前 10 分钟，并配上轻松的背景音乐。”

浏览可用素材：

“向我展示所有字幕模板” / “有哪些背景音乐可用？”

查看进度：

“我的视频请求目前是什么状态？”

获取结果：

“向我展示请求 507f1f77bcf86cd799439011 的剪辑，并按传播分数排序。”

环境变量

变量	必填	描述
SSEMBLE_API_KEY	是	你的 Ssemble API 密钥（以 sk_ssemble_ 开头）
SSEMBLE_API_BASE_URL	否	覆盖 API 基础 URL（默认值：https://aiclipping.ssemble.com/api/v1）

开发

git clone https://gitlab.com/vlogr/ssemble-mcp-server.git
cd ssemble-mcp-server
npm install
SSEMBLE_API_KEY=sk_ssemble_your_key npm start

许可证

MIT