Ssemble MCP 服务器

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）

• 浏览资源：字幕模板、背景音乐、游戏画面叠加、模因钩子

• 跟踪处理进度：检查进度并检索已完成的剪辑

• 管理请求：列出历史记录、获取结果、删除旧请求

Related MCP server: clipwise-mcp

前置要求

• 拥有有效订阅的 Ssemble 账户

• API 密钥（从 Ssemble 仪表板的“设置”→“API 密钥”中获取）

• 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"
      }
    }
  }
}

可用工具

处理流程说明

视频处理需要 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 的剪辑，按病毒式评分排序"

环境变量

开发

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