@avclabs.ai/enhance-mcp
OfficialProvides tools to interact with a FastAPI-based video enhancement service, allowing users to create and manage video enhancement tasks, upload videos, and retrieve results.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@avclabs.ai/enhance-mcp enhance https://example.com/video.mp4 to 1080p"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@avclabs.ai/enhance-mcp (Node.js)
中文 | English
基于 MCP 协议的视频增强服务,作为 MCP Client-Server 与 FastAPI HTTP Server 交互。
功能
提供以下 MCP Tools:
create_task- 创建视频增强任务(支持 URL 或本地文件上传)get_task_status- 查询任务状态enhance_video_sync- 同步增强视频(阻塞等待完成)
前置要求
Node.js >= 18(检查:
node --version)API Key(从控制台创建)
懒人安装(推荐)
如果你使用的 AI Agent 有确定的 MCP 配置路径,直接复制下面这句发给 AI:
帮我安装 npm 包 @avclabs.ai/enhance-mcp 作为 MCP server。我的 API Key 是:sk-xxxxxxxx。AI 会自动完成:
检测你使用的 MCP 客户端
找到配置文件路径
写入正确的配置
提示你重启客户端
手动安装
无需安装,直接在 MCP 客户端配置中使用 npx 运行。
1. Claude Code(CLI)
在 Claude Code 中运行:
/mcp查看输出中 "User MCPs" 对应的配置文件路径,然后编辑该文件。
常见路径(如果 /mcp 不可用):
Windows:
%USERPROFILE%\.claude.jsonmacOS:
~/.claude.jsonLinux:
~/.claude.json旧版/备用:
~/.claude/mcp.json
粘贴以下内容(将 your-api-key 替换为实际 API Key):
{
"mcpServers": {
"video-enhancement": {
"command": "npx",
"args": ["-y", "@avclabs.ai/enhance-mcp"],
"env": {
"HTTP_API_KEY": "your-api-key"
}
}
}
}保存后运行 /mcp 验证是否加载成功。
2. Cursor
进入 设置 > Tools & MCPs > Add New MCP Server:
Name:
video-enhancementType:
commandCommand:
env HTTP_API_KEY=your-api-key npx -y @avclabs.ai/enhance-mcp
或编辑 ~/.cursor/mcp.json:
{
"mcpServers": {
"video-enhancement": {
"command": "npx",
"args": ["-y", "@avclabs.ai/enhance-mcp"],
"env": {
"HTTP_API_KEY": "your-api-key"
}
}
}
}验证安装
重启客户端后,确认工具是否加载成功:
或直接问 AI:"你有哪些可用的工具?"
应看到:
create_task、get_task_status、enhance_video_sync
配置项
变量名 | 必填 | 默认值 | 说明 |
| 是 | - | API 认证密钥 |
| 否 |
| 服务接口地址 |
自定义服务地址
{
"env": {
"HTTP_API_BASE_URL": "https://your-endpoint.com",
"HTTP_API_KEY": "your-api-key"
}
}或通过命令行参数:
npx -y @avclabs.ai/enhance-mcp --base-url https://your-endpoint.com --api-key your-api-key使用示例
配置完成后,用自然语言对 AI 说:
"帮我把这个视频增强到 1080p:https://example.com/video.mp4"
"把我桌面的 video.mp4 提升到 2k 画质"
AI 会自动调用相应工具完成任务。
提供的 Tools
create_task
创建视频增强任务(异步)。
参数 | 类型 | 必填 | 默认值 | 说明 |
| string | 是 | - | 视频 URL 或本地文件路径 |
| string | 否 |
|
|
| string | 否 |
|
|
返回值:
{
"success": true,
"task_id": "xxx",
"status": "wait"
}get_task_status
查询任务状态。
参数 | 类型 | 必填 |
| string | 是 |
返回值:
{
"success": true,
"task_id": "xxx",
"status": "completed",
"progress": 100,
"video_url": "https://..."
}enhance_video_sync
同步增强视频(阻塞等待完成)。
参数 | 类型 | 必填 | 默认值 | 说明 |
| string | 是 | - | 视频 URL 或本地文件路径 |
| string | 否 |
|
|
| string | 否 |
| 目标分辨率 |
| number | 否 |
| 轮询间隔(秒) |
| number | 否 |
| 超时时间(秒) |
文件上传说明
当 type 为 "local" 时,MCP Server 会:
读取本地文件
通过预签名 URL 直传到 TOS 对象存储
最大文件大小:100MB
故障排查
"command not found: npx"
安装 Node.js >= 18:https://nodejs.org/
"错误: 需要提供 --api-key 或设置 HTTP_API_KEY"
API Key 缺失,请检查配置中的 env.HTTP_API_KEY。
MCP Server 在客户端显示红色/错误
查看日志:
Claude Desktop macOS:
~/Library/Logs/Claude/mcp*.logClaude Desktop Windows:
%APPDATA%\Claude\logs\mcp*.logCursor:Output 面板 > MCP
"TOS 上传失败"
通常是签名不匹配,请确认 HTTP_API_BASE_URL 和 HTTP_API_KEY 正确且有效。
全局安装(可选)
如果你不想每次都用 npx:
npm install -g @avclabs.ai/enhance-mcp然后在配置中使用 "command": "avclabs-enhance-mcp" 配合 "args": ["--api-key", "your-api-key"] 。
License
MIT License - 详见 LICENSE 文件
Available Tools
3 toolscreate_taskB
创建视频增强任务(异步)
支持两种上传方式:
URL 上传:提供视频 URL
本地上传:提供本地文件路径,MCP Server 自动上传到 TOS 对象存储
参数说明:
video_source: 视频 URL 或本地文件路径
type: "url" 或 "local"
resolution: 目标分辨率
Inputs: video_source (required), type, resolution.
enhance_video_syncA
同步增强视频(阻塞等待完成)
支持两种上传方式:
URL 上传:提供视频 URL
本地上传:提供本地文件路径,MCP Server 自动上传到 TOS 对象存储
参数说明:
video_source: 视频 URL 或本地文件路径
type: "url" 或 "local"
resolution: 目标分辨率
poll_interval: 轮询间隔(秒)
timeout: 超时时间(秒)
Inputs: video_source (required), type, resolution, poll_interval, +1 more.
get_task_statusA
查询视频增强任务状态
Inputs: task_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a distinct purpose: creating an async task, performing a synchronous enhancement, and querying task status. No overlap or ambiguity.
All names use snake_case and verb_noun pattern, but the verbs vary (create, enhance, get) and 'enhance_video_sync' mixes a descriptor. Mostly consistent.
Three tools is on the lower end but reasonable for a focused video enhancement service. Each tool serves a clear function without being redundant.
Covers creation and status checking, but lacks cancellation, listing all tasks, or retrieving final results explicitly. Minor but notable gaps.
Maintenance
Related MCP Connectors
Hosted MCP tools for FFmpeg-style video and audio processing through FFMPEG API.
Upscale videos to 4K and enhance motion with frame interpolation. DetailX MCP supports upload instructions, credit estimates, video enhancement jobs, status tracking and result downloads through browser OAuth; generation requires a DetailX account and credits.
Upscale videos to 4K and enhance motion with frame interpolation. DetailX MCP supports upload instructions, credit estimates, video enhancement jobs, status tracking and result downloads through browser OAuth; generation requires a DetailX account and credits.
Plan, compare, price, generate, and recover AI video from compatible MCP clients.