vidmcp 1.0.0

AI video editing MCP server — SAM 3.1 segmentation, behind-the-subject VFX, education scenes

VidMCP

Agents don’t describe video. They cut it.

MCP server for text-prompt mattes · behind-the-subject VFX · education scenes
Built by Dhiraj Lochib · Site vidmcp.com

---

Gallery

_{Behind the subject — particles under the matte}

Tesseract · 4D with trails	Kinetic · agent edit language
Unit circle · live sin / cos	Pipeline · import → render

Sample	GIF	MP4
Flow field	gif	mp4
Tesseract	gif	mp4
Behind the subject	gif	mp4
Kinetic	gif	mp4
Unit circle	gif	mp4
Pipeline	gif	mp4

python scripts/generate_samples.py

---

Install

Needs: Python 3.11+, ffmpeg

git clone https://github.com/dhirajlochib/VidMcp.git
cd VidMcp
python3 -m venv .venv && source .venv/bin/activate
pip install -e .

export VIDMCP_SAM_BACKEND=mock
export VIDMCP_WORKSPACE_ROOT=./workspaces
vidmcp --doctor
vidmcp

Optional

pip install -e ".[mlx]"   # Apple Silicon SAM 3.1
pip install -e ".[sam]"   # CUDA
pip install -e ".[dev]"   # tests

---

MCP (Claude Desktop)

{
  "mcpServers": {
    "vidmcp": {
      "command": "/ABS/PATH/VidMcp/.venv/bin/vidmcp",
      "env": {
        "VIDMCP_SAM_BACKEND": "mock",
        "VIDMCP_WORKSPACE_ROOT": "/ABS/PATH/VidMcp/workspaces"
      }
    }
  }
}

claude mcp add vidmcp -s user -- /ABS/PATH/VidMcp/.venv/bin/vidmcp

---

What it does

Segment	Text-prompt subject matte (SAM / MLX / mock)
Compose	Effects behind the subject
Educate	Math plates + narration hooks
Harness	Plan → perceive → critic gates

create_project → import_video → segment_subject
  → apply_background_effects → composite_and_render

---

Project

src/vidmcp/       MCP server + tools
demos/samples/    GIFs · MP4s · stills
site/             vidmcp.com (Hostinger)
configs/          Claude / Cursor
scripts/          generate_samples.py

---

Author

Dhiraj Lochib — Full-Stack, Blockchain, AI
dhirajlochib.com · GitHub · LinkedIn · [e-mail]

---

License

MIT