VidMCP

orient → denoise → BGM → captions → optional BG replace → export preset

from vidmcp.tools.creator import run_talking_head_polish

print(run_talking_head_polish(
    "talk.mov",
    preset="reels_9x16",
    bg_mode="space",   # none | space | blur | solid
    strength=0.75,
    bgm_volume=0.35,
))

run_intent("polish talk head for reels, space bg, cut fillers", video_path="talk.mov")
project_brief(project_id)          # prefer over full get_project
list_tool_packs() / set_tool_pack("vfx")
get_project(id, detail=true)       # full manifest only when needed

uv tool install vidmcp
vidmcp --doctor

# or
pip install 'vidmcp[creator]'   # + faster-whisper + mediapipe

# Grok
grok mcp add vidmcp \
  -e VIDMCP_SAM_BACKEND=mock \
  -e VIDMCP_WORKSPACE_ROOT=$HOME/vidmcp-workspaces \
  -e VIDMCP_TOOL_PACK=talking_head \
  -e VIDMCP_COMPACT=1 \
  -- uvx vidmcp

{
  "mcpServers": {
    "vidmcp": {
      "command": "uvx",
      "args": ["vidmcp"],
      "env": {
        "VIDMCP_SAM_BACKEND": "mock",
        "VIDMCP_WORKSPACE_ROOT": "/path/to/workspaces",
        "VIDMCP_TOOL_PACK": "talking_head",
        "VIDMCP_COMPACT": "1"
      }
    }
  }
}

pip install 'vidmcp[mlx]'
export VIDMCP_SAM_BACKEND=mlx
export VIDMCP_MLX_MODEL_ID=mlx-community/sam3.1-bf16

create_project → import_video (orient)
  → process_audio → mix_bgm
  → segment_subject | replace_background
  → transcribe_and_caption → export_render

src/vidmcp/     MCP server, creator tools, perception, effects
demos/samples/  GIFs · MP4s for README & site
site/           vidmcp.com (static Hostinger)
configs/        Claude / Cursor snippets