How do I use @avclabs.ai/enhance-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. 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)

npm version Node.js >=18 License: MIT

中文文档 | English

A video enhancement service based on the MCP protocol, acting as an MCP Client-Server to interact with a FastAPI HTTP Server.

Features

The following MCP Tools are provided:

create_task - Create a video enhancement task (supports URL or local file upload)
get_task_status - Query task status
enhance_video_sync - Synchronously enhance a video (blocking wait)

Installation

Install from npm (Recommended)

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

Or use yarn/pnpm:

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

Install from Source

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

Usage

1. Command Line

Use directly after global installation:

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

Or use environment variables:

# 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. Configure in Claude Desktop

Edit the Claude Desktop configuration file:

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. Use with npx (No Global Installation Required)

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

Claude Desktop configuration:

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

Provided Tools

create_task

Create a video enhancement task (asynchronous).

Parameters:

video_source (string, required): Video URL or local file path
type (string, optional): Upload type, defaults to "url"
- Options: "url" - Network video URL, "local" - Local file path
resolution (string, optional): Target resolution, defaults to 720p
- Options: 480p, 540p, 720p, 1080p, 2k

Example:

// 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"
}

Returns:

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

get_task_status

Query task status.

Parameters:

task_id (string, required): Task ID

Example:

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

Returns:

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

Synchronously enhance a video (blocking wait until completion).

Parameters:

video_source (string, required): Video URL or local file path
type (string, optional): Upload type, defaults to "url"
- Options: "url" - Network video URL, "local" - Local file path
resolution (string, optional): Target resolution, defaults to 720p
poll_interval (number, optional): Polling interval in seconds, defaults to 5
timeout (number, optional): Timeout in seconds, defaults to 600

Example:

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

Returns:

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

File Upload Notes

When type is set to "local", the MCP Server will:

Read the local file
Encode the file as base64
Upload it to the video enhancement service

Limitations:

Maximum file size: 100MB

Environment Variables

Variable	Description	Default
`HTTP_API_BASE_URL`	FastAPI HTTP Server address	`https://mcp.avc.ai`
`HTTP_API_KEY`	API authentication key	None

Development

# 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

License

MIT License - See LICENSE file for details.

@avclabs.ai/enhance-mcp

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

Features

Installation

Install from npm (Recommended)

Install from Source

Usage

1. Command Line

2. Configure in Claude Desktop

3. Use with npx (No Global Installation Required)

Provided Tools

create_task

get_task_status

enhance_video_sync

File Upload Notes

Environment Variables

Development

License

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API