Skip to main content
Glama
avclabs

@avclabs.ai/enhance-mcp

Official
by avclabs

@avclabs.ai/enhance-mcp (Node.js)

npm version Node.js >=18 License: MIT

中文文档 | English

一个基于 MCP 协议的视频增强服务,作为 MCP 客户端-服务器与 FastAPI HTTP 服务器进行交互。

功能特性

提供以下 MCP 工具:

  • create_task - 创建视频增强任务(支持 URL 或本地文件上传)

  • get_task_status - 查询任务状态

  • enhance_video_sync - 同步增强视频(阻塞等待)

安装

从 npm 安装(推荐)

npm install -g @avclabs.ai/enhance-mcp

或者使用 yarn/pnpm:

yarn global add @avclabs.ai/enhance-mcp
pnpm add -g @avclabs.ai/enhance-mcp

从源码安装

git clone https://github.com/avclabs/enhance-mcp.git
cd js_client
npm install
npm run build

使用方法

1. 命令行

全局安装后直接使用:

avclabs-enhance-mcp --base-url https://mcp.avc.ai --api-key your-api-key

或者使用环境变量:

# Windows PowerShell
$env:HTTP_API_BASE_URL="https://mcp.avc.ai"
$env:HTTP_API_KEY="your-api-key"
avclabs-enhance-mcp

# Windows CMD
set HTTP_API_BASE_URL=https://mcp.avc.ai
set HTTP_API_KEY=your-api-key
avclabs-enhance-mcp

# macOS/Linux
export HTTP_API_BASE_URL=https://mcp.avc.ai
export HTTP_API_KEY=your-api-key
avclabs-enhance-mcp

2. 在 Claude Desktop 中配置

编辑 Claude Desktop 配置文件:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "video-enhancement": {
      "command": "avclabs-enhance-mcp",
      "args": [
        "--base-url",
        "https://mcp.avc.ai",
        "--api-key",
        "your-api-key"
      ]
    }
  }
}

3. 使用 npx(无需全局安装)

npx @avclabs.ai/enhance-mcp --base-url https://mcp.avc.ai --api-key your-api-key

Claude Desktop 配置:

{
  "mcpServers": {
    "video-enhancement": {
      "command": "npx",
      "args": [
        "@avclabs.ai/enhance-mcp",
        "--base-url",
        "https://mcp.avc.ai",
        "--api-key",
        "your-api-key"
      ]
    }
  }
}

提供的工具

create_task

创建视频增强任务(异步)。

参数:

  • video_source (string, 必填): 视频 URL 或本地文件路径

  • type (string, 可选): 上传类型,默认为 "url"

    • 选项: "url" - 网络视频 URL, "local" - 本地文件路径

  • resolution (string, 可选): 目标分辨率,默认为 720p

    • 选项: 480p, 540p, 720p, 1080p, 2k

示例:

// URL mode
{
  "video_source": "https://example.com/video.mp4",
  "type": "url",
  "resolution": "1080p"
}

// Local file mode
{
  "video_source": "/path/to/local/video.mp4",
  "type": "local",
  "resolution": "1080p"
}

返回:

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

get_task_status

查询任务状态。

参数:

  • task_id (string, 必填): 任务 ID

示例:

{
  "task_id": "task-123-abc"
}

返回:

{
  "success": true,
  "task_id": "xxx",
  "status": "completed",
  "progress": 100,
  "video_url": "https://...",
  "error_message": null,
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-01T00:01:00Z"
}

enhance_video_sync

同步增强视频(阻塞等待直到完成)。

参数:

  • video_source (string, 必填): 视频 URL 或本地文件路径

  • type (string, 可选): 上传类型,默认为 "url"

    • 选项: "url" - 网络视频 URL, "local" - 本地文件路径

  • resolution (string, 可选): 目标分辨率,默认为 720p

  • poll_interval (number, 可选): 轮询间隔(秒),默认为 5

  • timeout (number, 可选): 超时时间(秒),默认为 600

示例:

{
  "video_source": "https://example.com/video.mp4",
  "type": "url",
  "resolution": "1080p",
  "poll_interval": 5,
  "timeout": 600
}

返回:

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

文件上传注意事项

type 设置为 "local" 时,MCP 服务器将:

  1. 读取本地文件

  2. 将文件编码为 base64

  3. 上传至视频增强服务

限制:

  • 最大文件大小:100MB

环境变量

变量

描述

默认值

HTTP_API_BASE_URL

FastAPI HTTP 服务器地址

https://mcp.avc.ai

HTTP_API_KEY

API 认证密钥

开发

# Clone the repository
git clone https://github.com/avclabs/enhance-mcp.git
cd js_client

# Install dependencies
npm install

# Development mode (auto-compile)
npm run dev

# Build
npm run build

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

Install Server
A
license - permissive license
A
quality
D
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • Multimodal video analysis MCP — transcription, vision, and OCR for any video URL.

  • MCP server for Kling AI video generation

  • MCP server for Wan AI video generation

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/avclabs/enhance-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server