Instavar Video Templates and Studio

@instavar/mcp-server

1つのMCPパッケージで、無料で始めて、必要に応じて機能を拡張できます。アカウントやAPIキーなしで、Claude CodeまたはCodexからInstavarの独立したオープンソースのRemotionテンプレートを使って、ローカル動画を作成できます。

Instavarは独立したプロジェクトであり、Remotion AGとの提携、同社による後援、または承認を受けていません。RemotionはRemotion AGの商標です。

ホスト型ワークフロー 作成 → レンダリング → 承認 → 公開 → 指標を使う場合は、Instavar APIキーを追加してください。認証が必要なツールは、ホスト型Instavar APIへの薄いHTTPクライアントです。このパッケージはデータベース接続を保持せず、独自のデータも保存しません。無料ツールはそのまま使えるため、2つ目のサーバーをインストールする必要はありません。

適切な機能から始める

エージェントが再利用可能なRemotion動画テンプレート、クリエイティブのガイダンス、VideoSpecの例、またはローカルレンダリングエラーへの対応を必要とする場合は、Instavarを使います。まずget_capabilitiesを呼び出し、コピーやデザインの作成に取りかかる前にget_creative_guideを呼び出してください。list_templatesとget_templateで対応している構成を選び、get_exampleまたはscaffold_video_specで仕様を準備します。get_render_instructionsでは、別途行うローカル検証、プレビュー、レンダリングのワークフローを確認できます。計画とひな形の作成では、メディアのレンダリング、アップロード、公開は行われません。

ブラウザー型エージェント向けのホスト型HTTP接続をお探しですか？https://instavar.com/api/mcp/templatesをご利用ください。この接続はSmitheryのInstavar Video Templatesにも掲載されています。この関連エンドポイントでは、ストーリーボードとエディトリアルカルーセルの計画機能が追加されます。オプションのOAuthツールでは、プライベートプロジェクトの一覧表示とレビューのみが可能です。このエンドポイントは、このnpmパッケージや、保護されたStudioエンドポイントの全機能と同一ではありません。公開計画にInstavarアカウントは不要ですが、ディレクトリやゲートウェイによっては、独自のログインが必要になる場合があります。

ホスト型Studioでの制作は任意であり、費用が発生する場合があります。動画の計画依頼を、有料ジョブのレンダリングやソーシャル投稿の公開許可として扱わないでください。

実行されるモデル

汎用LLMはMCPホストが提供します。

• Claude Codeでは、選択したClaudeモデルがリクエストを解釈し、Instavarツールを呼び出します。
• Codexでは、選択したOpenAIモデルがリクエストを解釈し、同じツールを呼び出します。
• その他の互換性のあるホストでは、それぞれの選択したモデルと認証が使用されます。

MCPサーバーは、Sonnet、GPT、その他の汎用モデルを提供するものではありません。ユーザーのホストですでに実行されているモデルに、型付きのInstavar機能を公開します。ホストやサインイン方法によっては、モデルの使用料金が個人またはワークスペースのサブスクリプション、別途の使用クレジット、またはAPI利用料金から差し引かれる場合があります。こうしたプロバイダーのルールは変更されることがあります。

ローカルのRemotionレンダリングでは、お使いのマシンを使用します。Instavarのホスト型サービス（レンダリング、ストレージ、専門的なメディア生成、QA、公開、およびその他明示されたジョブ費用を含む）は、利用量を計測し、料金を請求します。サブスクリプションを利用するエージェントを使っても、これらのサービスが無料になるわけではありません。

一般公開されているセットアップガイダンスと例については、Instavar video templatesをご覧ください。

セットアップ

MCPクライアントの設定にサーバーを追加します。

{
  "mcpServers": {
    "instavar": {
      "command": "npx",
      "args": ["-y", "@instavar/mcp-server"]
    }
  }
}

これにより、無料のローカルテンプレートツールから使い始められます。ホスト型Studioツールを利用するには、**https://instavar.com/studio/settings**でAPIキーを作成してから、次のように追加します。

{
  "mcpServers": {
    "instavar": {
      "command": "npx",
      "args": ["-y", "@instavar/mcp-server"],
      "env": { "INSTAVAR_API_KEY": "ik_live_..." }
    }
  }
}

クライアントを再起動します。どちらのモードでも無料ツールが表示されます。キーが設定されている場合は、ホスト型ツールも表示されます。

環境

変数	必須	デフォルト	用途
INSTAVAR_API_KEY	いいえ	—	ホスト型 Studio ツールのロックを解除します。組織にスコープが限定されており、取り消し可能です。
INSTAVAR_BASE_URL	いいえ	https://instavar.com	API ホストを上書きします。

ツール

npm 0.6.0 から、このパッケージには prepare_announcement も含まれています。Remotion と HyperFrames 用のペアになった告知カードを 1 つ作成します。ローカルソースと、持ち運び可能なコピー用ドキュメントを返します。保存済みのホスト型プロジェクトやレンダリング済み動画ではありません。フレームワークが指定されていない場合は確認してください。以降は、最後に返されたプロジェクトと、それに対応する expectedRevision を使用します。フレームワークを切り替えた場合、引き継がれるのはタイトル、本文、アクションのみです。

無料のローカルツール：

ツール	機能
get_capabilities	無料機能とオプションのアカウント機能を報告します。
get_creative_guide	コピー、ストーリー、デザイン、レビューに関する簡潔なガイダンスを読み込みます。
list_templates	公開済みの Remotion テンプレートファミリーを一覧表示します。
get_template	1 つのテンプレートの仕様を返します。
get_video_schema	公開されている VideoSpec JSON Schema を返します。
get_example	VideoSpec のスターターを返します。
scaffold_video_spec	決定的な VideoSpec のスケルトンを作成します。
get_render_instructions	ローカルでの検証とレンダリングのワークフローを返します。
diagnose_render_error	よくあるローカルレンダリングの失敗を分類します。

INSTAVAR_API_KEY が設定されている場合に利用できるホスト型ツール：

ツール	内容
list_jobs	最近のジョブを新しい順に一覧表示します。
get_job_status	実行、成果物、検証、現在の動画とサムネイルの URL を取得します。
get_video_state	ジョブのマテリアライズ済み構成状態を取得します。
diagnose_render	エビデンスの制限と再試行の推奨事項を含む、読み取り専用の統合レンダリング診断を実行します。
get_job_metrics	公開済みジョブのプラットフォームエンゲージメントのスナップショットを取得します。
get_cost_summary	インフラコストの概要を取得します（Lambda / RunPod / R2 / WaveSpeed / PoYo）。
inspect_workflow	現在のワークフローとそのバージョン履歴を読み取ります。
create_video_brief	構造化されたブリーフからジョブを作成し、レンダリングを開始します。
edit_video_brief	ブリーフにパッチを適用します（objective / publishTarget を含む）。publishTarget のみが変更された場合を除き、再レンダリングします。
retry_video_qa	同じ現在の固定済み動画成果物に対して、劣化または利用できない QA を再試行します。
audit_video_qa	同じ固定済み動画に対して、Qwen3.6-Plus による参考意見を実行します。
regenerate_narration	変更されていない永続ブリーフからナレーションと、それに依存する動画を再生成します。
draft_workflow	確認済みの expectedVersion を使用して完全なワークフローを保存します（バージョンがない場合のみ 0）。
patch_workflow	再帰的パッチから、競合を考慮したワークフローバージョンを作成します。
validate_workflow	レンダリングせずに、確認済みのワークフローバージョンを検証してコンパイルします。
preview_workflow	レンダリングせずに、コンパイル済みの UniversalVideo ブリーフを読み取ります。
compare_workflows	永続化された 2 つのワークフローバージョンをフィールドごとに比較します。
approve_workflow	確認済みの有効なバージョンを承認します。動画ジョブの承認や公開は行いません。
approve_job	レンダリング済みのジョブを承認し、公開できるようにします。
publish_job	承認済みのジョブを接続済みのソーシャルメディアの配信先に公開します。
connect_account	ソーシャルアカウントの接続を開始します（ヘッドレス OAuth ペアリング）。
connect_account_status	保留中のアカウント接続を、接続済みになるまで確認します。

ワークフローの確認、プレビュー、比較には read が必要です。ワークフローの下書き、パッチ適用、検証、承認には write が必要です。publish_job には publish が必要です。

ワークフローツールは、未知の引数を黙って破棄せず、エラーとして拒否します。API 呼び出しは 15 秒後にタイムアウトします。古いバージョンによる 409 は、呼び出し元に最新バージョンを確認するよう伝えます。一方、アップロードを利用できない場合やその他の依存関係の競合が発生した場合は、再試行する前にその依存関係を解決するよう伝えます。

ターミナルからソーシャルアカウントを接続する

connect_account は、承認 URL と短い 確認コード を返します。Instavar にサインインしているブラウザーで URL を開き、コードがターミナルに表示されたものと一致することを確認してから承認してください。プラットフォーム標準のサインイン手続きを経て、Instavar に戻ります。返された pairingId を使って connect_account_status を確認し、connected と報告されるまで繰り返します。ペアリングの有効期限は 10 分で、ワークスペースのオーナーまたは管理者のみが承認できます。

CLI

npx @instavar/mcp-server --version
npx @instavar/mcp-server --help

ライセンス

MIT

クリエイティブガイド

get_creative_guide はキーなしで動作します。4 つのガイドを確認するには guideId を省略するか、visual-copy、carousel-stories、visual-design、human-review のいずれかを選択してください。同じテキストは instavar://creative-guides/<guideId> の Markdown リソースとしても利用できます。呼び出し元のアシスタントがユーザーの依頼内容にガイドを適用します。このツールはコピーの生成、レンダリング、フィードバックの保存、メディアの公開は行いません。カルーセルのレシピは計画のためのガイダンスであり、追加の npm レンダラーではありません。

モノレポのソースは docs/guides/creative/ にあります。編集後は node scripts/build-creative-guides.mjs を実行してください。--check は古いバンドルがある場合にエラーを返します。生成された TypeScript はパッケージにバンドルされるため、インストール済みのクライアントはチェックアウトしたファイルやプライベートなナレッジストアへのアクセスを必要としません。インストール済みのクライアントにソースの変更を反映するには、通常の npm リリースが必要です。