Installation Guide

@avclabs.ai/media-mcp · Node.js >=18 · MIT License

Release statusnpm latest is 0.3.0 with all 9 tools (3 video + 4 image + 2 SAM3), all production-ready. Standalone per-capability packages (video / image / SAM3 segmentation) are coming soon.

Choose the capability you need

Each capability is its own MCP server. Install only what you need: smaller context, more accurate tool selection.

Video Enhancement

Package:@avclabs.ai/video-mcp· 3 toolsComing soon

This standalone package is not on npm yet; these tools are available today in the all-in-one package.

Image Enhancement

Package:@avclabs.ai/image-mcp· 4 toolsComing soon

This standalone package is not on npm yet; these tools are available today in the all-in-one package.

Image Segmentation (SAM3)

Package:@avclabs.ai/sam3-mcp· 2 toolsComing soon

This standalone package is not on npm yet; these tools are available today in the all-in-one package.

Available today: the all-in-one package

The standalone capability packages are not on npm yet; the all-in-one package gives you all 9 tools today.

1. Claude Code (CLI)

Run in Claude Code:

bash

/mcp

Find the config file path from "User MCPs" in the output, then edit that file.

Common paths (if /mcp is not available):

Windows：%USERPROFILE%\.claude.json

macOS：~/.claude.json

Linux：~/.claude.json

Legacy/Alternative：~/.claude/mcp.json

Paste the following (replace your-api-key with your actual API Key):

json

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

Save and run /mcp to verify it loads successfully.

2. Cursor

Settings > Tools & MCPs > Add New MCP Server

Name：media-mcp
Type：command
Command：env API_KEY=your-api-key npx -y -p @avclabs.ai/media-mcp@latest media-mcp

Or edit ~/.cursor/mcp.json:

json

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

Existing configurations

The all-in-one package remains fully supported and existing configs need no migration; once the standalone packages ship, new integrations should install per capability.

Global Install (Optional)

If you don't want to use npx every time:

bash

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

Then use "command": "media-mcp" with "args": ["--api-key", "your-api-key"] in the configuration.

json

{
  "mcpServers": {
    "media-mcp": {
      "command": "media-mcp",
      "args": ["--api-key", "your-api-key"]
    }
  }
}