MCP サーバー:動画アップスケール

VideoUpscaler の MCP サーバーを Claude Code、Cursor、VS Code に接続すれば、AI アシスタントに頼むだけで動画を 1080p・2K・4K にアップスケールできます。

VideoUpscaler は Model Context Protocol に対応した、動画アップスケール用のリモート MCP サーバーを提供しています。AI アシスタントに接続すれば、「この動画を 4K にアップスケールして」のように頼むだけで、アシスタントがこのドキュメントで説明している API を呼び出し、あなたのクレジットを使用します。

サーバー URL: https://videoupscaler.co/api/mcp(Streamable HTTP)

有料アカウント向け(残高確認は全員可)

API と同様に、MCP サーバーはクレジットを購入したことがあるアカウント、またはサブスクリプションを契約しているアカウントで利用できます。クライアントは VideoUpscaler アカウントへのサインイン、または APIキー で接続します。どのアカウントでもサインインして get_account でクレジット残高を確認できます。その他のツールには有料アカウントが必要です。

クライアントを接続する

ほとんどのクライアントはサインインで接続します。サーバー URL を追加するとブラウザが開くので、VideoUpscaler にサインインして 許可 をクリックしてください。サインインできないクライアントは APIキーを使います。設定 → APIキー で作成し、VIDEOUPSCALER_API_KEY などの環境変数に保存してください。コミットする設定ファイルにキーを直接貼り付けないでください。

claude.ai または Claude デスクトップアプリで Settings → Connectors を開き、Add custom connector をクリックして https://videoupscaler.co/api/mcp を入力します。Connect をクリックし、サインインしてアクセスを許可してください。

claude mcp add --transport http videoupscaler https://videoupscaler.co/api/mcp --scope user

Claude Code で /mcp を実行し、videoupscaler を選んで Authenticate を選択すると、ブラウザでサインインできます。--scope user を付けると、すべてのプロジェクトでこのサーバーを使えます。

APIキーを使う場合は、コマンドに --header "Authorization: Bearer $VIDEOUPSCALER_API_KEY" を追加してください。

Cursor は APIキーで接続します。~/.cursor/mcp.json(すべてのプロジェクト)または .cursor/mcp.json(1つのプロジェクト)に追加します:

{
  "mcpServers": {
    "videoupscaler": {
      "url": "https://videoupscaler.co/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:VIDEOUPSCALER_API_KEY}"
      }
    }
  }
}

.vscode/mcp.json に追加します。サーバーを初めて起動したときに、VS Code がサインインを求めます:

{
  "servers": {
    "videoupscaler": {
      "type": "http",
      "url": "https://videoupscaler.co/api/mcp"
    }
  }
}

Streamable HTTP のリモート MCP サーバーに対応したクライアントなら利用できます。URL https://videoupscaler.co/api/mcp を入力すると、MCP の認可に対応したクライアントは自動でサインインを案内します。それ以外のクライアントは Authorization: Bearer <APIキー> ヘッダーを送信してください。

ツール

ツール内容
upscale_video公開されている video_url を 1080p、2k、4k にアップスケールする処理を開始し、クレジットを差し引きます。idempotency_key が必要です。
get_taskタスクを返します。wait_seconds(最大 45)を指定すると、タスクの完了を待ってから返します。
list_tasks最近のタスクを一覧表示します。Web サイトで開始したタスクも含まれます。
get_accountクレジット残高と、解像度ごとの 1 秒あたりの料金を返します。
create_upload公開 URL のないローカルファイル(最大 100MB)をアップロードするための署名付き URL を返します。

各ツールは対応する API エンドポイントとまったく同じように動作します。詳しくはアップスケールを作成、タスク、クレジットと料金、ファイルをアップロードを参照してください。MCP 経由で開始したタスクにかかるクレジットも同じです。

upscale_video の呼び出しには毎回 idempotency_key が必要です。呼び出しがタイムアウトした場合、アシスタントは list_tasks を確認し、同じキーで再試行する必要があります。これにより、同じ動画に二重に課金されることはありません。

プロンプトの例

  • 「VideoUpscaler のクレジットはあとどれくらい残っている?」
  • 「https://example.com/clip.mp4 を 4K にアップスケールして、終わったらリンクを教えて。」
  • 「./intro.mp4 を 2K にアップスケールして。」(コマンドを実行できるクライアントは、先に create_upload でファイルをアップロードします)

トラブルシューティング

問題対処法
クライアントに 401 が表示される、またはサインインを求められるクライアントからもう一度サインインしてください。APIキーの場合は、Authorization ヘッダーと、キーが設定にまだ存在するかを確認してください。
サインインページに「認可リンクが無効」と表示されるリンクの有効期限は 10 分です。クライアントから接続をやり直してください。
ツールが paid_plan_required を返すこのアカウントはクレジットを購入したことがありません。いずれかのクレジットパックを購入してください。
ツールが insufficient_credits を返す料金ページで残高をチャージしてください。
upscale_video がタイムアウトするサイズの大きいリモート動画はダウンロードに時間がかかります。アシスタントに list_tasks を確認するよう頼んでください。通常、タスクは作成されています。