CueFrame

CueFrame — MCP、CLI、動画 API

CueFrame は、動画の作成、編集、レンダリングを行うホスト型サービスです。MCP 経由でエージェントを接続したり、CLI から編集作業を自動化したり、REST API をアプリケーションに組み込んだりできます。どの方法でも、クリップ、キャプション、モーショングラフィックスを含む編集可能なプロジェクトを扱い、MP4 にレンダリングできます。

初回のレンダリング · 接続ガイド · テンプレート · API リファレンス · エージェント向けドキュメントの目次

Yosemite Peregrines テンプレートの一場面です。動画を見て、同じ編集を試してみましょう。

MCP とエージェントプラグイン

Claude Code、Codex、Cursor、VS Code、その他の対応するローカルエージェントでは、Node.js 24 以降を使ってターミナルで次を実行してください。

npx -y [email protected] install

インストーラーは対応するエージェントを検出し、ホスト型 CueFrame MCP エンドポイントを設定に追加します。スキルを ~/.agents/skills と ~/.claude/skills にインストールし、デフォルトではローカルで変更されたスキルを保持します。検出された複数のクライアントを更新できます。まず変更内容を確認するには、--dry-run を使用してください。

エージェントのセッションを再起動し、次のように依頼してください。

CueFrame の get_account ツールを使って接続を確認し、利用可能なクレジットを表示してください。

クライアントから認証を求められたり、ブラウザーが開いたりする場合があります。CueFrame にサインインして接続を承認してください。インタラクティブな OAuth クライアントでは API キーは不要です。クラウド操作にはクレジットを使用します。有料作業を開始する前に残高と見積もりコストを確認してください。クラウド料金をご覧ください。

ChatGPT と Claude Desktop： クライアントのホスト型コネクター設定で https://api.cueframe.ai/v1/mcp を使用し、認証してください。ターミナルインストーラーでは ChatGPT は設定されません。対応する接続方法については、接続ガイドとCueFrame 接続スキルをご覧ください。スキルのインストールとホスト型コネクターの設定は別々の手順です。

すでに接続済みですか？ インストールは省略して、エージェントに動画作成を依頼してください。CueFrame のツールが表示されない場合は、クライアントを再起動し、MCP の接続設定を確認してください。

最初の動画を作成する

Yosemite の初回レンダリングの手順を試してみましょう。テンプレートをレンダリングし、単語を 1 つ変更して、同じプロジェクトからもう一度レンダリングします。

1. National Park Service からオリジナルの映像素材全体をダウンロードし、yosemite-peregrines.mp4として保存します。完成版のデモにはタイトルが埋め込まれているため、必ずオリジナルの素材を使用してください。素材のダウンロードと再利用に関するガイダンスに従ってください。

2. 接続済みのエージェントに素材ファイルと次の指示を渡します。

   CueFrame を使って、オリジナルの動画を使用し、cueframe-ai/cueframe-templates の yosemite-peregrines テンプレートを開始してください。template.cueframe と、用意されている被写体マットを読み込んでください。編集可能なプロジェクトをプレビューし、クラウド費用を見積もってください。レンダリングを承認した後、MP4 のリンクとプロジェクト ID を返してください。

3. 最初のレンダリング後、次のように依頼します。

   同じプロジェクトで、被写体の背後にあるタイトル PHENOMENAL を EXTRAORDINARY に置き換えてください。映像素材、音声キャプション、音声、タイミング、配置、奥行きはそのまま維持してください。変更後のタイトルをプレビューし、レンダリング費用を見積もってから、私の承認後にレンダリングしてください。

テンプレートでは、オリジナル動画の 83.616～93.359 秒が選択されています。1 つの編集可能なプロジェクトから、2 本の MP4 を作成できます。映像素材のアップロードとクラウド操作にはクレジットが必要です。2 回のレンダリングはそれぞれ別に課金されます。

プロジェクトは引き続き編集できます。デスクトップエディターでは、映像素材やキャプションと並んで、タイトルが独立したレイヤーとして表示されます。タイトルの変更を見る。

MCP ではどのように動作しますか？

flowchart LR
    A[Your request + footage] --> B[Your agent + CueFrame skills]
    B --> C[Hosted CueFrame MCP]
    C --> D[Editable project + preview]
    D --> E[Render job → MP4 link]

エージェントは利用可能なツールを確認し、アカウントをチェックして、メディアとプロジェクトを準備し、変更をプレビューして、レンダリングを送信します。時間のかかる操作では ID が返され、エージェントは完了を待って結果を提示します。ツール呼び出しを自分で記述する必要はありません。詳細なクイックスタートでは、個々の呼び出しについて説明しています。

次の動画を作るときは、仕上がりを説明し、入力素材を渡してください。

このインタビューを、単語ごとのタイミングに合わせたキャプション付きの 20 秒の縦型クリップにしてください。最も印象的な場面をプレビューし、レンダリング前に費用の見積もりを表示してください。

これらの商品写真に合う画像カルーセルコンポーネントを探してください。動画を作成する前に、適切な候補と必要な入力を表示してください。

このプロジェクトの最後のタイトルだけを変更してください。それ以外の編集は変更しないでください。

その他のインストール方法

セットアップ方法を 1 つ選んでください。プラグインをインストールすると、スキルとホスト型 MCP 設定がまとめてインストールされます。サーバーのみを接続するとツールが追加され、スキルによってワークフローのガイダンスが提供されます。

claude plugin marketplace add cueframe-ai/cueframe-mcp
claude plugin install cueframe@cueframe

codex plugin marketplace add cueframe-ai/cueframe-mcp
codex plugin add cueframe@cueframe

gemini extensions install https://github.com/cueframe-ai/cueframe-mcp

npx skills add cueframe-ai/cueframe-mcp

claude mcp add --transport http cueframe https://api.cueframe.ai/v1/mcp

スキルは、エージェントが動画タスクを実行する方法を学ぶためのものです。タスクを説明すると、エージェントが関連するガイダンスを選択します。

Claude Code のセッションフックと Cursor のルールは、最初に使う項目の選択を支援します。その他のホストでは、それぞれの仕組みを通じてインストール済みのスキルを読み込みます。対象を限定した編集では、無関係な作業を保持してください。

CLI

明示的な動画コマンド、シェルスクリプト、構造化された JSON 出力には CLI を使用します。ホスト型 API に接続し、ローカルのレンダラーは実行しません。Node.js 24 以降が必要です。

npx -y [email protected] --help
npx -y [email protected] login
npx -y [email protected] api GET /v1/me --json
npx -y [email protected] describe --json

login は認証のためにブラウザーを開きます。ヘッドレススクリプトでは CUEFRAME_API_KEY を指定できます。アカウントリクエストは接続とクレジットを確認します。describe は API を呼び出さずに、コマンドの引数とオプションを一覧表示します。

CLI ガイド · CLI の使い方 · テンプレート · npm パッケージ

API と TypeScript SDK

REST API を使用すると、アプリケーションからプロジェクトを作成し、メディアをインポートし、コンポジションを変更して、レンダージョブの進行状況を追跡できます。リクエストは、アカウントから取得した API キーを使って https://api.cueframe.ai に送信します。従量制の操作の前にアカウントを確認してください。クラウドでのレンダリングと処理にはクレジットを使用します。

Node.js 24 以降で TypeScript または JavaScript を使用する場合は、型付きクライアントをインストールします。

npm install @cueframe/sdk

import { account, createClient } from "@cueframe/sdk";

if (!process.env.CUEFRAME_API_KEY) throw new Error("Set CUEFRAME_API_KEY");
createClient({
  baseUrl: "https://api.cueframe.ai",
  apiKey: process.env.CUEFRAME_API_KEY,
});
const result = await account.getAccount();
console.log(result.plan, result.entitlements);

その他の言語では、REST を直接呼び出すか、バージョン管理された公開 OpenAPI コントラクトからクライアントを生成できます。SDK はホスト型サービスのクライアントであり、サーバーの実装ではありません。

API の使い方 · API リファレンス · SDK ガイド · レンダリング例 · npm パッケージ

このリポジトリの内容

このリポジトリには、エージェントプラグイン、開発者向けツールキット、レジストリファイルが含まれています。ホスト型 MCP サーバーは、アプリケーションリポジトリで別途管理されています。CueFrame のホスト型サービスに接続するため、このリポジトリをクローンしても、そのサービスがローカルで実行されることはありません。

貢献する

ドキュメント、クライアントの例、スキルの改善、ツールキットの修正を歓迎します。初めての方におすすめの Issueから始めるか、セットアップ、生成ファイルのルール、テスト、コミットへの署名についてはCONTRIBUTING.mdをお読みください。

スキルはルートのskills/で編集してください。生成される API クライアントは、ドキュメントに記載された入力を通じて変更してください。ホスト型サービスの問題は、再現手順と、可能であればリクエスト ID を添えて、このリポジトリの Issue トラッカーに報告してください。脆弱性はSECURITY.mdに従って非公開で報告してください。コミュニティへの参加には行動規範が適用されます。

公開パッケージ

パッケージ	目的	npm
@cueframe/api-contract	パブリック OpenAPI ドキュメント、レビュー済みの操作一覧、コンテンツアドレス方式のマニフェスト。生成クライアントが読み取る唯一の入力です。
@cueframe/sdk	zod リクエストスキーマと、レンダリングおよびコンポーズの進捗を扱う SSE ヘルパーを備えた、型付き fetch ベースの TypeScript クライアントです。
cueframe	CLI：ログイン、プロジェクト、メディア、コンポジション、レンダリング、エクスポート、installを提供します。すべてのコマンドで--jsonを使用できます。
@cueframe/skills	skills/ツリーを npm パッケージとして提供します（@cueframe/skills/dirからのSKILLS_DIR）。スキルをコピーまたは埋め込むプログラム向けです。

MCP サーバー自体（@cueframe/mcp）は、アプリケーションリポジトリで管理されている非公開パッケージです。このリポジトリが提供するのは、その生成元となるコントラクト、クライアント、プラグイン、レジストリエントリ（server.json）、および検出用シムであり、サーバーそのものではありません。

コントラクトの流れ

private API ──sync──▶ api/openapi.json (+ scene-schema.json, scene-examples.json, contract-manifest.json)
                          │
                          ├──▶ packages/api-contract/dist  ──publish──▶  @cueframe/[email protected] ──▶ the MCP server's generators, third parties
                          └──▶ packages/sdk/src/generated        (Orval: operations, models, zod)

非公開 API は OpenAPI の投影をapi/に公開し、pnpm generate:api-consumersを実行すると、そこから SDK が再生成されます。コントラクトのコピーはこれだけです。アプリケーションリポジトリにある MCP サーバーのジェネレーターも、ほかのすべてのコンシューマーも、@cueframe/api-contract npm パッケージから読み取ります。このパッケージのバージョンはコントラクトとともに更新されるため（pnpm check:contract-versionは、バージョンを上げずにapi/*.jsonを変更すると失敗します）、ツールの提供範囲と SDK は常に同じコントラクトを記述します。api/やgenerated/ディレクトリ内のファイルを手作業で編集することはありません。pnpm check:api-inputsで3つのapi/*.json入力が1回の同期で作られたことを確認し、pnpm check:api-consumer-driftで生成されたツリーが入力とバイト単位で一致することを確認します。

スキルの流れ

ルートの skills/ が唯一のソースです。プラグインホストはこのリポジトリから読み込み、pnpm build が packages/skills/dist（@cueframe/skills として公開）にコピーし、そこから CLI の dist/skills にコピーして cueframe install で使用します。pnpm check:plugin はすべてのスキルとマニフェストを検証します。各スキルの隣にある agents/openai.yaml と assets/icon.svg は生成されます。

レジストリファイル

• server.json：ホスト型サーバー（ai.cueframe/cueframe、リモートのみ）の MCP レジストリエントリです。pnpm check:server-json は同梱されたレジストリスキーマに対して検証し、公開ワークフローの registry ジョブがこれを公開します。
• glama.json：Glama の掲載情報に関するメンテナーファイルです。
• glama/ と Dockerfile：stdio 経由でイントロスペクションを行うレジストリ向けに、ホスト型サーバーのツール一覧と手順のスナップショットを再生する stdio 検出用シムです。サーバーではありません（下記を参照）。

ホスト型、デスクトップローカル、および検出用シム

ホスト型サービス、デスクトップ連携、レジストリ用シムは、それぞれ異なる目的を担います。

• ホスト型サーバー https://api.cueframe.ai/v1/mcp が製品です。上記のインストールコマンドはすべてこれに接続します。OAuth または API キーで認証し、構成とレンダリングを行います。パッケージ @cueframe/mcp は非公開です。
• CueFrame デスクトップアプリには、開いているプロジェクト用のローカル MCP サーバーが同梱されています。アカウントは不要で、アプリが公開する接続ファイルを通じて接続します。正確なコマンドはアプリの Agents 設定に表示され、https://docs.cueframe.ai で説明されています。同梱バイナリの名前は cueframe-mcp で、アプリバンドル内にあります。
• このリポジトリの検出用シム（glama/server.mjs、Dockerfile でビルド）はサーバーではありません。イメージをビルドするレジストリがアカウントなしでツールを掲載できるよう、ホスト型サーバーのツール一覧と手順のスナップショットを stdio 経由で再生します。すべての tools/call はホスト型サーバーへの案内を返します。スナップショットの取得元は glama/refresh-snapshot.md に記載されています。

リポジトリの構成

• skills/<name>/SKILL.md：スキルです。隣にある agents/openai.yaml と assets/icon.svg は生成されます（pnpm build:plugin）。
• .claude-plugin/、hooks/、.mcp.json：Claude Code のプラグイン、セッションルーター、サーバーです。
• .codex-plugin/、.agents/plugins/、mcp.json：Codex と ChatGPT のプラグインおよびマーケットプレイスです。
• .cursor-plugin/、rules/：Cursor のプラグインと常時適用されるルールです。
• gemini-extension.json、skills.sh.json、plugin.json：Gemini CLI、skills.sh、ポータブルマニフェスト（agent-plugins.org）です。
• api/、packages/、tools/、scripts/：コントラクト、4 つの npm パッケージ、それらのジェネレーターとチェックです（プラグインのものは scripts/plugin/ にあります）。
• server.json、glama.json、glama/、Dockerfile：レジストリファイルです。
• catalog/：cueframe-ai/cueframe の MCP カタログからエクスポートされたツールリファレンスとエラーコードです（そこで pnpm --filter @cueframe/mcp export:tool-reference -- <this repository>/catalog を実行します）。skills/cueframe-connect/references/tools.md はここから生成され、スキルのチェックでも読み込まれます。スキルで名前を挙げられるのは、一覧に含まれるツールだけです。
• examples/、llms-install.md：クライアントごとのセットアップと、エージェントが読み取れるインストールガイドです。

開発

pnpm install
pnpm check      # input provenance, the contract version rule, the public-contract gate, server.json, the plugin, and tsc --noEmit in sdk and cli
pnpm build      # stamps the plugin manifests and skill cards, then tsup in every package; the CLI packages the skills
pnpm test

Node 24 以降と pnpm が必要です（.nvmrc と packageManager を参照）。CONTRIBUTING.md では、生成されるパス、スキルのコントラクト、変更が反映される流れを説明しています。AGENTS.md は、このツリーで作業するエージェント向けに同じ内容を記載しています。llms-install.md では、クライアントの手順を順を追って説明しています。

ライセンス

Apache-2.0。LICENSE と NOTICE を参照してください。