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と連携可能）

• アセットの閲覧：キャプションテンプレート、BGM、ゲームプレイオーバーレイ、ミームフック

• 処理の追跡：進捗状況の確認と完成したクリップの取得

• リクエストの管理：履歴の表示、結果の取得、古いリクエストの削除

Related MCP server: clipwise-mcp

前提条件

• 有効なサブスクリプションを持つ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"
      }
    }
  }
}

利用可能なツール

処理の仕組み

動画の処理には5〜30分かかります。2つのワークフローが利用可能です：

オプションA：ポーリング（手動確認）

1. create_short — ジョブを送信し、リクエストIDを即座に返します

2. get_status — いつでも進捗を確認できます（キューイング中 → 処理中 → 完了）

3. get_shorts — 完了時に生成されたクリップを取得します

オプションB：Webhook（自動化）

1. webhookUrl を指定して create_short を実行 — コールバックURLと共にジョブを送信します

2. 処理が完了または失敗すると、APIが結果と共にHTTP POSTをURLに送信します

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分間を使い、落ち着いたBGMを付けて"

利用可能なアセットを閲覧：

"キャプションテンプレートをすべて見せて" / "どんなBGMが利用できる？"

進捗を確認：

"動画リクエストのステータスはどうなってる？"

結果を取得：

"リクエスト 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