vmaf-mcp

DEPRECATED (ADR-1229). The MCP server is now the Go binary vmafx-mcp (cmd/vmafx-mcp/), installed at /usr/local/bin/vmafx-mcp in every container image. Attach with docker exec -i vmaf-dev-mcp vmafx-mcp. This Python package implements the same fifteen tools and is retained for one release as a reference implementation; it is no longer installed by dev/Containerfile and a follow-up removes it. Do not add tools here — add them to cmd/vmafx-mcp/.

MCP (Model Context Protocol) server that exposes the VMAFx fork's scoring CLI to LLM tooling via JSON-RPC over stdio.

Tools

Install

cd mcp-server/vmaf-mcp
pip install -e .

Requires a built libvmaf binary at build/tools/vmaf (override via VMAF_BIN=/abs/path/to/vmaf).

Run

# Stdio transport (default for Claude Desktop, Cursor, etc.)
vmaf-mcp

Path allowlisting

For safety, the server only reads files under testdata/, python/test/resource/, and model/. Extend via colon-separated VMAF_MCP_ALLOW:

VMAF_MCP_ALLOW=/data/my-corpus:/mnt/yuv vmaf-mcp

Claude Desktop config

{
  "mcpServers": {
    "vmaf": {
      "command": "vmaf-mcp",
      "env": {
        "VMAF_BIN": "/home/you/dev/vmaf/build/tools/vmaf",
        "VMAF_MCP_ALLOW": "/data/yuv-corpus"
      }
    }
  }
}