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。不要把 Key 貼進會提交到儲存庫的設定檔。
claude mcp add --transport http videoupscaler https://videoupscaler.co/api/mcp \
--header "Authorization: Bearer $VIDEOUPSCALER_API_KEY" \
--scope user--scope user 會讓這個伺服器在你所有的專案中都能使用，也能避免 Key 寫進專案的 .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 第一次會要求你輸入 Key，並以安全的方式儲存：
{
"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 標頭，並確認該 Key 仍存在於「設定」中。 |
工具回傳 paid_plan_required | 此帳號從未購買過點數。購買任一點數方案即可。 |
工具回傳 insufficient_credits | 請到價格頁面儲值。 |
upscale_video 逾時 | 較大的遠端影片需要一些時間下載。請助理查看 list_tasks，任務通常已經建立。 |