Media MCP server

media-mcp (Node.js)

Deployment update (2026-09-06): the SAM3 source and release scripts are now maintained in sam3-http-server, rooted at /opt/ai/sam3. API schema candidate head is 20260906_0007. SAM3 production bootstrap and nine-tool E2E remain pending. See the four-project rollout.

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.

Release status (2026-09-06): npm latest is 0.2.1; that published artifact contains 5 tools (3 video + 2 SAM3) and its runtime metadata incorrectly reports 0.3.0. This repository is the unreleased 0.3.0 candidate, which fixes version consistency and adds 4 image tools plus an optional IMAGEAPIBASE_URL override. Image and video share the same public HTTP server and /enhance base URL; the candidate backend keeps their prepare concurrency, Redis queues, workers, and processing concurrency separate. The image routes now exist in candidate code but are not deployed or real-AI/TOS verified, so the image tools below are not a production npm capability until all 9 tools pass smoke tests and 0.3.0 is published.

Features

Provides the following MCP Tools:

Video Enhancement

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

Image Enhancement (unreleased 0.3.0 candidate)

• enhanceimagesync - Enhance image quality and optimize faces (supports URL or local file upload)
• colorizeimagesync - Colorize black-and-white photos (supports URL or local file upload)
• denoiseimagesync - Remove noise from images (supports URL or local file upload)
• getimagetask_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)
• getsam3task_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:

Shortened. The full README is on GitHub.