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 服务器仅向购买过积分或订阅过的账号开放。你需要一个 API 密钥。

接入客户端

在设置 → API 密钥中创建 API 密钥，并保存在环境变量中，例如 VIDEOUPSCALER_API_KEY。不要把密钥粘贴到会提交进代码仓库的配置文件里。

claude mcp add --transport http videoupscaler https://videoupscaler.co/api/mcp \
  --header "Authorization: Bearer $VIDEOUPSCALER_API_KEY" \
  --scope user

--scope user 让该服务器在你的所有项目中可用，同时避免密钥写入项目的 .mcp.json。在 Claude Code 中运行 /mcp 即可检查连接状态。

添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

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

添加到 .vscode/mcp.json。VS Code 会在首次使用时询问密钥，并安全地保存：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "videoupscaler-key",
      "description": "VideoUpscaler API key",
      "password": true
    }
  ],
  "servers": {
    "videoupscaler": {
      "type": "http",
      "url": "https://videoupscaler.co/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:videoupscaler-key}"
      }
    }
  }
}

任何支持通过 Streamable HTTP 连接远程 MCP 服务器的客户端都可以使用。配置如下：

URL：https://videoupscaler.co/api/mcp
请求头：Authorization: Bearer <your API key>

OAuth 登录（用于 Claude 桌面端和 claude.ai 连接器）即将推出。

工具

工具	作用
`upscale_video`	将公开的 `video_url` 增强到 `1080p`、`2k` 或 `4k`，并扣除积分。必须提供 `idempotency_key`。
`get_task`	返回一个任务。传入 `wait_seconds`（最多 45）时，会先等待任务完成再返回。
`list_tasks`	列出你最近的任务，包括在网站上发起的任务。
`get_account`	你的积分余额，以及各分辨率每秒的价格。
`create_upload`	返回签名 URL，用于上传没有公开 URL 的本地文件（最大 100MB）。

这些工具的行为与对应的 API 接口完全一致：参见创建画质增强任务、任务、积分与价格和上传文件。通过 MCP 发起的任务消耗的积分相同。

每次调用 upscale_video 都需要 idempotency_key。如果调用超时，助手应先查看 list_tasks，再用同一个 key 重试，这样同一个视频永远不会被重复扣费。

示例提示词

“我的 VideoUpscaler 还剩多少积分？”
“把 https://example.com/clip.mp4 提升到 4K，处理完把链接发给我。”
“把 ./intro.mp4 提升到 2K。”（能执行命令的客户端会先用 create_upload 上传文件）

常见问题排查

问题	解决方法
客户端显示 `401` 或要求你登录	API 密钥缺失或有误。检查 `Authorization` 请求头，并确认该密钥在设置中仍然存在。
工具返回 `paid_plan_required`	该账号从未购买过积分。购买任意积分包即可。
工具返回 `insufficient_credits`	在价格页面充值余额。
`upscale_video` 超时	较大的远程视频需要一段时间下载。让助手查看 `list_tasks`，任务通常已经创建。

MCP 服务器：视频放大

把 VideoUpscaler 的 MCP 服务器接入 Claude Code、Cursor 或 VS Code，直接让 AI 助手把视频放大到 1080p、2K 或 4K。

服务器 URL： https://videoupscaler.co/api/mcp（Streamable HTTP）

仅限付费账号

与 API 一样，MCP 服务器仅向购买过积分或订阅过的账号开放。你需要一个 API 密钥。

接入客户端

在设置 → API 密钥中创建 API 密钥，并保存在环境变量中，例如 VIDEOUPSCALER_API_KEY。不要把密钥粘贴到会提交进代码仓库的配置文件里。

claude mcp add --transport http videoupscaler https://videoupscaler.co/api/mcp \
  --header "Authorization: Bearer $VIDEOUPSCALER_API_KEY" \
  --scope user

--scope user 让该服务器在你的所有项目中可用，同时避免密钥写入项目的 .mcp.json。在 Claude Code 中运行 /mcp 即可检查连接状态。

添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

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

添加到 .vscode/mcp.json。VS Code 会在首次使用时询问密钥，并安全地保存：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "videoupscaler-key",
      "description": "VideoUpscaler API key",
      "password": true
    }
  ],
  "servers": {
    "videoupscaler": {
      "type": "http",
      "url": "https://videoupscaler.co/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:videoupscaler-key}"
      }
    }
  }
}

任何支持通过 Streamable HTTP 连接远程 MCP 服务器的客户端都可以使用。配置如下：

URL：https://videoupscaler.co/api/mcp
请求头：Authorization: Bearer <your API key>

OAuth 登录（用于 Claude 桌面端和 claude.ai 连接器）即将推出。

工具

工具	作用
`upscale_video`	将公开的 `video_url` 增强到 `1080p`、`2k` 或 `4k`，并扣除积分。必须提供 `idempotency_key`。
`get_task`	返回一个任务。传入 `wait_seconds`（最多 45）时，会先等待任务完成再返回。
`list_tasks`	列出你最近的任务，包括在网站上发起的任务。
`get_account`	你的积分余额，以及各分辨率每秒的价格。
`create_upload`	返回签名 URL，用于上传没有公开 URL 的本地文件（最大 100MB）。

这些工具的行为与对应的 API 接口完全一致：参见创建画质增强任务、任务、积分与价格和上传文件。通过 MCP 发起的任务消耗的积分相同。

每次调用 upscale_video 都需要 idempotency_key。如果调用超时，助手应先查看 list_tasks，再用同一个 key 重试，这样同一个视频永远不会被重复扣费。

示例提示词

“我的 VideoUpscaler 还剩多少积分？”
“把 https://example.com/clip.mp4 提升到 4K，处理完把链接发给我。”
“把 ./intro.mp4 提升到 2K。”（能执行命令的客户端会先用 create_upload 上传文件）

常见问题排查

问题	解决方法
客户端显示 `401` 或要求你登录	API 密钥缺失或有误。检查 `Authorization` 请求头，并确认该密钥在设置中仍然存在。
工具返回 `paid_plan_required`	该账号从未购买过积分。购买任意积分包即可。
工具返回 `insufficient_credits`	在价格页面充值余额。
`upscale_video` 超时	较大的远程视频需要一段时间下载。让助手查看 `list_tasks`，任务通常已经创建。

MCP 服务器：视频放大

接入客户端

工具

示例提示词

常见问题排查

On this page

MCP 服务器：视频放大

接入客户端

工具

示例提示词

常见问题排查

On this page