# Avc Test Py MCP

> Avc Test Py MCP is an open-source MCP server for media validation. MCP server that submits video enhancement jobs to a FastAPI backend from AI clients. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, macOS, Windows, Linux
- **Repository:** https://github.com/z416479660/avc-test-py-mcp
- **MCP Registry name:** io.github.z416479660/avc-test-py-mcp
- **Categories:** [media validation](https://ai-powered.com/categories/media-validation)
- **Listing updated:** 2026-11-18

## About

The README describes this as a bridge between MCP clients and a FastAPI video enhancement service. Once configured, an assistant such as Claude Desktop can create enhancement jobs from a video URL or a local file, check job progress, or submit a job and wait until it finishes. Local files are read, base64-encoded and uploaded, with a stated 100MB size limit.

The server runs over stdio and is started from the avc-test-py-mcp command after installing from PyPI, or through uv. It needs a base URL and an API key, which are passed as flags or environment variables. The README also points to a Node.js package with the same tool set.

It suits developers and operators who already have access to this specific enhancement backend and want to drive it from an MCP-compatible assistant. The README does not describe pricing for the hosted service.

## Features

- **Asynchronous enhancement tasks:** Creates a video job from a URL or local path and returns a task ID to track.
- **Task status lookup:** Returns progress, status and output video URL for a given task ID.
- **Blocking enhancement mode:** Waits with configurable polling interval and timeout until the job completes.
- **Resolution selection:** Accepts target resolutions from 480p up to 2k, defaulting to 720p.
- **Local file upload:** Encodes local videos as base64 and uploads them, capped at 100MB.
- **Stdio transport setup:** Runs as a local stdio server configured through environment variables or CLI flags.

## Good for

- Asking an AI assistant to enhance a video from a web link to 1080p
- Uploading a local clip for enhancement without leaving an MCP-enabled chat
- Polling a previously created job for its completed output URL
- Scripting batch enhancement through the MCP tools

## Install

### Claude Code (Terminal)

```sh
claude mcp add avc-test-py-mcp --env HTTP_API_KEY='<HTTP_API_KEY>' -- npx -y avc-test-js-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "avc-test-py-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avc-test-js-mcp"
      ],
      "env": {
        "HTTP_API_KEY": "<HTTP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "avc-test-py-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avc-test-js-mcp"
      ],
      "env": {
        "HTTP_API_KEY": "<HTTP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "avc-test-py-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "avc-test-js-mcp"
      ],
      "env": {
        "HTTP_API_KEY": "<HTTP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "avc-test-py-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avc-test-js-mcp"
      ],
      "env": {
        "HTTP_API_KEY": "<HTTP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "avc-test-py-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avc-test-js-mcp"
      ],
      "env": {
        "HTTP_API_KEY": "<HTTP_API_KEY>"
      }
    }
  }
}
```

## Tools

- `create_task`: Creates an asynchronous video enhancement task from a URL or local file.
- `get_task_status`: Queries the status, progress and output of a task by ID.
- `enhance_video_sync`: Enhances a video and blocks until the task completes or times out.

## FAQ

### Which tools does the server expose?

The README lists create_task, get_task_status and enhance_video_sync.

### What is the maximum local file size?

The README states a maximum file size of 100MB for local uploads.

### Which resolutions are supported?

The README lists 480p, 540p, 720p, 1080p and 2k as target resolutions, with 720p as default.

### How is the server installed?

The README recommends installing from PyPI with pip or uv, or installing from source in editable mode.

### Is Avc Test Py MCP free?

Yes. Avc Test Py MCP is open source, so you can use and self-host it for free.

### How do I add Avc Test Py MCP to Claude Code?

Run this command in your terminal: claude mcp add avc-test-py-mcp --env HTTP_API_KEY='<HTTP_API_KEY>' -- npx -y avc-test-js-mcp

### What are the best alternatives to Avc Test Py MCP?

The closest alternatives to Avc Test Py MCP are Wanhe Compliance — Chinese Content Compliance Checker, Iranseda Radio Archive, 麒典直播工作台, Telewebion TV and Aparat Videos.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Wanhe Compliance — Chinese Content Compliance Checker](https://ai-powered.com/mcp/wanhe-compliance-chinese-content-compliance-checker): Wanhe Compliance — Chinese Content Compliance Checker is an open-source MCP server for security.
- [Iranseda Radio Archive](https://ai-powered.com/mcp/iranseda-radio-archive): Iranseda Radio Archive is an open-source MCP server for design and media.
- [麒典直播工作台](https://ai-powered.com/mcp/listing-mwlcy0qs): 麒典直播工作台 is an open-source MCP server for media validation.
- [Telewebion TV](https://ai-powered.com/mcp/telewebion-tv): Telewebion TV is an open-source MCP server for media validation.
- [Aparat Videos](https://ai-powered.com/mcp/aparat-videos): Aparat Videos is an open-source MCP server for media validation.
- [AudioWrench Audio Tools](https://ai-powered.com/mcp/audiowrench-audio-tools): AudioWrench Audio Tools is an MCP server for design and media.
- [MediaHarvest](https://ai-powered.com/mcp/mediaharvest): MediaHarvest is an open-source MCP server for design and media.
- [Cutsio](https://ai-powered.com/mcp/cutsio): Cutsio is an MCP server for media validation.

---
Source: https://ai-powered.com/mcp/avc-test-py-mcp
