media-mcp (Node.js)

English | 中文

A video enhancement, image enhancement/colorization/denoising, and image segmentation service based on the MCP protocol, acting as an MCP Client-Server to interact with backend HTTP Servers.

Features

Provides the following MCP Tools:

Video Enhancement

• create_task - Create a video enhancement task (supports URL or local file upload)
• get_task_status - Query task status
• enhance_video_sync - Synchronously enhance video (blocking wait, truncated at ~50s by default)

Image Enhancement

• enhance_image_sync - Enhance image quality and optimize faces (supports URL or local file upload)
• colorize_image_sync - Colorize black-and-white photos (supports URL or local file upload)
• denoise_image_sync - Remove noise from images (supports URL or local file upload)
• get_image_task_status - Query image task status (for polling after sync timeout)

Image Segmentation (SAM3)

• sam3_predict - SAM3 image segmentation (supports local path, URL, or Base64 image)
• get_sam3_task_status - Query SAM3 task status (for polling after sync timeout)

Prerequisites

• Node.js >= 18 (check: node --version)
• API Key (required for authentication)

Lazy Install (Recommended)

If your AI Agent has a known MCP config path, just copy the line below and send it to your AI:

Install the npm package @avclabs.ai/media-mcp as an MCP server. My API Key is: sk-xxxxxxxx.

The AI will automatically:

1. Detect your MCP client
2. Find the config file path
3. Write the correct configuration
4. Prompt you to restart the client

Manual Install

No installation needed. Use npx directly in your MCP client config.

1. Claude Code (CLI)

Run in Claude Code:

/mcp

Check the output for the "User MCPs" section to find the config file path, then edit that file.

Common paths (if /mcp is unavailable):

• Windows: %USERPROFILE%\.claude.json
• macOS: ~/.claude.json
• Linux: ~/.claude.json
• Legacy/Alternative: ~/.claude/mcp.json

Paste this (replace your-api-key):

{
  "mcpServers": {
    "video-enhancement": {
      "command": "npx",
      "args": ["-y", "@avclabs.ai/media-mcp@latest"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

Save and run /mcp to verify it's loaded.

2. Cursor

Go to Settings > Tools & MCPs > Add New MCP Server:

• Name: video-enhancement
• Type: command
• Command:

  env API_KEY=your-api-key npx -y @avclabs.ai/media-mcp@latest
  

Or edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "video-enhancement": {
      "command": "npx",
      "args": ["-y", "@avclabs.ai/media-mcp@latest"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

Verify Installation

After restarting your client, check if the tools are available:

1. Or ask: "What tools do you have available?"
2. You should see: create_task, get_task_status, enhance_video_sync, enhance_image_sync, colorize_image_sync, denoise_image_sync, get_image_task_status, sam3_predict, get_sam3_task_status

Configuration Options

... View full README on GitHub