Skip to content
MCP server

BGRemover MCP — Video Alpha Inspection

Reads alpha-channel statistics from local videos to check real transparency

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.1.0
Listing updated
3 days ago

About BGRemover MCP — Video Alpha Inspection

BGRemover MCP — Video Alpha Inspection is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

A transparent WebM that looks black in one player may simply have no alpha at all. This small local server answers that by looking at decoded samples instead of container metadata, and it deliberately does not remove backgrounds or convert media.

Two tools do the work. One analyses a Base64 block of 8-bit alpha bytes you supply and reports pixel counts, mean, range and transparency fractions; the README's example of bytes 0, 128, 255, 255 gives a mean of 159.5. The other samples frames of a video inside a directory you authorise and returns decoded statistics with a bounded conclusion.

Video inspection needs FFmpeg and ffprobe with VP8/VP9 decoders installed separately, and the media root is set by the person configuring the client, not the caller. It is the open-source companion to the BGRemover Online service.

Install

Run in a terminal

claude mcp add bgremover -- npx -y bgremover-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "bgremover": {
      "command": "npx",
      "args": [
        "-y",
        "bgremover-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "bgremover": {
      "command": "npx",
      "args": [
        "-y",
        "bgremover-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "bgremover": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "bgremover-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "bgremover": {
      "command": "npx",
      "args": [
        "-y",
        "bgremover-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "bgremover": {
      "command": "npx",
      "args": [
        "-y",
        "bgremover-mcp"
      ]
    }
  }
}

Configuration

  • BGREMOVER_MEDIA_ROOTOptional existing local directory for read-only video inspection; omit to disable file access.
  • BGREMOVER_FFMPEGOptional trusted FFmpeg executable path; defaults to ffmpeg on PATH.
  • BGREMOVER_FFPROBEOptional trusted ffprobe executable path; defaults to ffprobe on PATH.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

analyze_alpha_plane
Statistics from supplied Base64 alpha bytes
inspect_video_alpha
Sample decoded alpha from a local video

What it does

Alpha plane analysis
Counts and fractions from supplied alpha bytes.
Video sampling
Inspect decoded frames at chosen fractions of a clip.
Read-only access
File reads are off unless a media directory is set.
No paid backend
No credits, account or API key are used.
Careful conclusions
Results are bounded rather than claiming a whole clip is opaque.

Good for

  • Verify a cutout WebM really carries alpha
  • Debug a transparent export that shows black
  • Check edge pixels of a matte before delivery
  • Test alpha logic with known byte arrays

Pricing

Open source

Open source; the web service sells credits from 6.99 USD, which this server does not use

Prices change. Check bgremover.online before you buy.

BGRemover MCP — Video Alpha Inspection FAQ

Does it remove backgrounds?

No. It only inspects transparency; background removal is the separate BGRemover Online service.

What must I install for video?

FFmpeg and ffprobe with libvpx VP8/VP9 decoders; the package does not download them.

Which folder can it read?

Only the existing directory set in BGREMOVER_MEDIA_ROOT; omit it to disable file access.

Is BGRemover MCP — Video Alpha Inspection free?

Yes. BGRemover MCP — Video Alpha Inspection is open source, so you can use and self-host it for free.

How do I add BGRemover MCP — Video Alpha Inspection to Claude Code?

Run this command in your terminal: claude mcp add bgremover -- npx -y bgremover-mcp

What are the best alternatives to BGRemover MCP — Video Alpha Inspection?

The closest alternatives to BGRemover MCP — Video Alpha Inspection are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

Alternatives to BGRemover MCP — Video Alpha Inspection

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media