JSON2Video

JSON2Video MCP サーバー

大規模な動画制作を自動化する動画 API、JSON2Video の公式 Model Context Protocol サーバーです。

AI エージェント（Claude、Cursor、VS Code、Windsurf、Cline…）を JSON2Video に接続して、完成した MP4 動画を作成できます。再利用可能なテンプレートから動画を作成し、AI 音声ナレーション、字幕、AI 生成の画像や動画を追加して、クラウドでレンダリングした動画の公開可能な URL を取得できます。

JSON2Video チームが開発・保守しています。 このサーバーは @json2video/cli npm パッケージに同梱されており、ローカルで stdio 経由で実行されます。

公式 MCP Registry には com.json2video/mcp として登録されています。

できること

• 「新製品について、音声ナレーションと字幕付きの30秒の縦型動画を作成して。」
• 「この 不動産物件情報 テンプレートを、これら10件の物件それぞれに対してレンダリングして。」
• 「毎日のニュースショート用のテンプレートを作成して、今日の3つのニュースをレンダリングして。」
• 「このロゴをアップロードして、動画にウォーターマークとして追加して。」
• 「残りのクレジット数を教えて。」

要件

• Node.js 20 以降
• JSON2Video API キー。無料で登録し、ダッシュボードからキーをコピーしてください。

インストール

Claude Code（プラグイン）

このリポジトリからプラグインをインストールします。Claude Code が API キーの入力を求め、安全に保存します。

/plugin install json2video --marketplace JSON2Video/json2video-mcp

古いバージョンの Claude Code では、先に /plugin marketplace add JSON2Video/json2video-mcp を実行してから、/plugin install json2video@json2video を実行してください。

Claude Code（手動）

プロジェクトフォルダーから実行する最も手早い方法です。

npm install -g @json2video/cli
json2video auth --api-key YOUR_API_KEY
json2video mcp install claude

これにより、サーバーがプロジェクトの .mcp.json に追加され、create-video スキルがインストールされます。これらのエディターでは、claude の代わりに cursor または vscode を使用してください。または、手動で追加できます。

claude mcp add json2video --env JSON2VIDEO_API_KEY=YOUR_API_KEY -- npx -y @json2video/cli mcp run

Claude Desktop、Cursor、Windsurf、その他のクライアント

クライアントの MCP 設定ファイル（claude_desktop_config.json、~/.cursor/mcp.json、~/.codeium/windsurf/mcp_config.json…）に以下を追加します。

{
  "mcpServers": {
    "json2video": {
      "command": "npx",
      "args": ["-y", "@json2video/cli", "mcp", "run"],
      "env": {
        "JSON2VIDEO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code

.vscode/mcp.json に以下を追加します。

{
  "servers": {
    "json2video": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@json2video/cli", "mcp", "run"],
      "env": {
        "JSON2VIDEO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

保存後、クライアントを再起動してください。各エディターの詳しい手順は、MCP サーバーのドキュメントをご覧ください。

ツール

ツール	機能
render_video	movie JSON または変数を指定したテンプレートから動画をレンダリングします。動画の URL を返します。
check_status	動画プロジェクトのレンダリング状況を確認します。
validate_movie	レンダリングせずに movie JSON を検証します。
list_templates	アカウント内のテンプレートを一覧表示します。
list_featured_templates	公開テンプレートライブラリ内のテンプレートを一覧表示します。
get_template	テンプレートの変数またはソース全体を取得します。
save_template	movie JSON を再利用可能なテンプレートとして保存します。
get_example	movie JSON の例を取得します。
get_help	movie JSON の構文、要素、トランジションに関するヘルプを取得します。
get_account	アカウント情報と残りのクレジット数を取得します。
media_list	メディアストレージ内のファイルを一覧表示します。
media_get	ファイルの詳細とダウンロード URL を取得します。
media_upload	ローカルパスまたは公開 URL からファイルをアップロードします。
media_delete	メディアストレージ内のファイルを削除します。

お使いのマシンで実行されるもの

プラグインと上記の設定では、npx -y @json2video/cli mcp run を実行します。npx は公開されている @json2video/cli パッケージを npm からダウンロードし、stdio 経由でローカルに MCP サーバーを起動します。サーバーは、API キーで認証したうえで、リクエスト（動画の JSON、テンプレート変数、アップロードするメディアファイル）を api.json2video.com の JSON2Video API に送信します。ヘルプやサンプルのリクエストに回答するため、cdn.json2video.com および JSON2Video の公開 S3 バケットから公開リファレンスファイル（ドキュメント、サンプル、音声と音楽の一覧）もダウンロードします。これ以外のサービスにデータを送信することはありません。

設定

環境変数	必須	説明
JSON2VIDEO_API_KEY	はい	JSON2Video API キーです。
JSON2VIDEO_TIMEOUT	いいえ	レンダリング完了までの最大待機時間（秒）。デフォルトは 240 です。

レンダリングには、JSON2Video アカウントのクレジットが使用されます。無料アカウントにはお試し用のクレジットが含まれています。詳細は料金をご覧ください。

リソース

• JSON2Video
• ドキュメント
• MCP サーバーガイド
• Claude Code での動画編集
• npm の @json2video/cli
• サポート：json2video.com のチャット

ライセンス

MIT