@avclabs.ai/enhance-mcp

v0.1.18

Published

20 days ago

HTTP MCP Client-Server for video enhancement API

0High
0Medium
0Low

super_bad

tangapple

mcp model-context-protocol video enhancement http client server claude anthropic

@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.json
macOS: ~/.claude.json
Linux: ~/.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-enhancement
Type：command

Command：

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

配置项

| 变量名 | 必填 | 默认值 | 说明 | |---|---|---|---| | HTTP_API_KEY | 是 | - | API 认证密钥 | | HTTP_API_BASE_URL | 否 | https://mcp.avc.ai | 服务接口地址 |

自定义服务地址

{
  "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

创建视频增强任务（异步）。

| 参数 | 类型 | 必填 | 默认值 | 说明 | |---|---|---|---|---| | video_source | string | 是 | - | 视频 URL 或本地文件路径 | | type | string | 否 | url | url 或 local | | resolution | string | 否 | 720p | 480p、540p、720p、1080p、2k |

返回值：

{
  "success": true,
  "task_id": "xxx",
  "status": "wait"
}

get_task_status

查询任务状态。

| 参数 | 类型 | 必填 | |---|---|---| | task_id | string | 是 |

返回值：

{
  "success": true,
  "task_id": "xxx",
  "status": "completed",
  "progress": 100,
  "video_url": "https://..."
}

enhance_video_sync

同步增强视频（阻塞等待完成）。

| 参数 | 类型 | 必填 | 默认值 | 说明 | |---|---|---|---|---| | video_source | string | 是 | - | 视频 URL 或本地文件路径 | | type | string | 否 | url | url 或 local | | resolution | string | 否 | 720p | 目标分辨率 | | poll_interval | number | 否 | 5 | 轮询间隔（秒） | | timeout | number | 否 | 600 | 超时时间（秒） |

文件上传说明

当 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*.log
Claude Desktop Windows：%APPDATA%\Claude\logs\mcp*.log
Cursor：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 文件