# BGRemover MCP — Video Alpha Inspection

> BGRemover MCP — Video Alpha Inspection is an open-source MCP server for design and media. Reads alpha-channel statistics from local videos to check real transparency. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://bgremover.online
- **Repository:** https://github.com/j-river/bgremover-mcp
- **MCP Registry name:** io.github.j-river/bgremover
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add bgremover -- npx -y bgremover-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/bgremover-mcp-video-alpha-inspection
