clipkit

@clipkit/mcp-server

Clipkit スキーマをツールとして公開し、AI エージェントがプログラムから動画プロジェクトを作成できる MCP サーバーです。Clipkit スキーマがプロトコルであり、エージェントは独自の DSL を使うのではなく、スキーマに準拠した JSON を構築します。

インストールと実行

npx -y @clipkit/mcp-server

または、Claude Desktop などのホストに接続します。

{
  "mcpServers": {
    "clipkit": {
      "command": "npx",
      "args": ["-y", "@clipkit/mcp-server"],
      "env": {
        "CLIPKIT_API_URL": "https://clipkit.dev",
        "CLIPKIT_API_KEY": "ck_live_…"
      }
    }
  }
}

環境変数

変数	目的
CLIPKIT_API_URL	create_promo / open_in_editor のリンク先ホストです。デフォルトは https://clipkit.dev です。ローカルのウェブアプリを使って開発する場合は、http://localhost:3000 を設定してください。
CLIPKIT_API_KEY	ダッシュボードキー（任意。ck_live_…。Settings → API keys から取得）です。設定すると、プロジェクトはチーム所有になり（有料プランでは永続）、Authorization: Bearer として送信されます。設定しない場合、プロジェクトは匿名となり、7 日後に期限切れになります。

ツール

ツール	説明
create_promo	デザイン済みのプロモーション動画を最も手早く作成します。シーンの順序付きリストをパターンライブラリで合成し、共有可能なエディターリンクを返します。
create_project	空のソースにリセットします。サイズ、長さ、fps、出力形式を指定することもできます。
set_project	ソース全体を、検証済みの JSON オブジェクトに置き換えます。構築する際の主な方法です（コンポジション、または多数の要素を一度に指定）。
add_element / edit_element / delete_element	既存のコンポジション内の単一要素を調整します。edit_element は部分的な要素をマージします（渡したキーのみが変更されます）。
get_project	現在の Clipkit ソース JSON を返します。
describe_project	寸法、トラックごとのタイムライン、要素数、レンダリング時の警告を平易な言葉で要約します。完全な JSON よりも低コストで確認できます。
validate_project	スキーマ検証に加え、有効な場合でもレンダリング時の警告を返します（フォントアトラスで絵文字や ASCII 以外の文字が除外される、要素が末尾を超えている、長さが未指定など）。
preview_still	1 フレームを PNG にレンダリングし、画像として返します。チャットモードのエージェントが作業内容を「見る」ために使います。無料で、レート制限があります。
transcribe_to_captions	メディアの url（またはローカルの path）を文字起こしし、単語ごとのタイムスタンプ付きキャプション要素に変換します。Whisper をプロセス内で実行するため、キーもアップロードも不要です。
open_in_editor	現在のプロジェクトを検証し、Clipkit エディターで開くリンクを返します（無料）。
load_project	共有 ID またはエディター URL で共有プロジェクトを再インポートします。open_in_editor の処理を逆方向に行います。
render_video	現在のプロジェクトをクラウドで完成版の MP4 にレンダリングします（有料。クレジットを消費し、CLIPKIT_API_KEY が必要です）。

変更はすべて、適用前に @clipkit/protocol のバリデーターを通ります。無効な編集では問題のあるパスを含む構造化エラーが返され、有効な編集はアトミックに適用されます。

ワークフロー

1. 作成 — デザイン済みの動画には create_promo を使うか、完全なソース JSON を記述して set_project を呼び出します。
2. 確認 — preview_still でフレームを確認し、validate_project / describe_project で構造を読み取ります。編集 → preview_still → 修正のサイクルを繰り返します。
3. 調整 — 大規模なコンポジションの単一要素を変更するには、add_element / edit_element / delete_element を使います。
4. 納品 — 無料のエディターリンクには open_in_editor を使います（後で再インポートするには load_project を使います）。完成版の MP4 を作成するには render_video を使います。

状態

状態はサーバーセッションごとにメモリー内に保持されます。MCP 接続ごとに新しいプロジェクトが作成されます。永続化されないため、プロジェクトを保存する場合は、エージェントが get_project を呼び出し、JSON を外部に保存してください。

スキーマリファレンス

要素タイプ（video、image、text、shape、audio、composition、caption）とそのフィールドの完全な一覧については、@clipkit/protocol を参照してください。