Mcpcut MCP server

Orccut

A real video editor for AI agents, served over MCP.

Orccut gives any MCP-capable agent (Claude Code, Claude Desktop, or anything else that speaks the protocol) an actual editing model — not a wrapper around one ffmpeg command. Projects are immutable snapshots with a journaled history of named operations; rendering goes through FFmpeg or the MLT framework; a deterministic CLI twin drives the same logic without a server.

Two ways to use it

☁️ Hosted (fastest — no install). orccut.com runs this editor as a service, with a browser editor on top: sign up, create an API token, and point your agent at the cloud MCP endpoint:

claude mcp add --transport http orccut https://orccut.com/mcp \
  --header "Authorization: Bearer <your token>"

You and your agent then work on the same projects — the agent edits over MCP, you review and tweak in the browser editor.

🖥 Self-hosted (this repository). The open, single-user core: run it on your own machine, point your agent at it, keep everything local. No accounts, no browser editor — just the MCP server, the editing engine and the CLI. The rest of this README is about this option.

What the agent gets

44 tools over one consistent model:

(editorgethistory shows every edit ever made), named versions with restore, annotations.

• Projects & history — create/list projects, journaled operations

resize, transforms with keyframes, transitions, canvas fit, color adjustments.

• Timeline — multiple video/audio tracks, clips with trim/split/move/

overlays, covers.

• Text & graphics — text overlays rasterized server-side, image/video

guard; media is sanity-checked with ffprobe before it touches a timeline).

• Audio — music beds, per-clip audio, volume envelopes.
• Media in — local paths or URLs (URL import goes through an SSRF egress

auto-captions via faster-whisper (.[asr] extra), local voiceover via piper (.[tts] extra, GPL — see THIRDPARTYNOTICES.md).

• Understanding — media analysis (scenes, audio peaks, keyframes),

export writes an .mlt sidecar you can open in Shotcut or Kdenlive.

• Out — validation, preview renders, full exports with presets. Each

Every mutation validates its arguments against the tool's real signature (strings can't leak into numeric filter fields), returns a fresh snapshot with a bumped version, and lands in the journal. Nothing edits in place.

Prerequisites

RENDER_ENGINE=ffmpeg and skip melt.

• Python 3.12+
• FFmpeg (ffmpeg + ffprobe on PATH)
• MLT (melt on PATH) — the default render engine. Alternatively set

apt install fonts-dejavu-core fonts-noto-color-emoji (elsewhere, point FONT_PATH at any .ttf).

• A font for text rendering, e.g. Debian/Ubuntu:

# Debian/Ubuntu, everything at once:
apt install ffmpeg melt fonts-dejavu-core fonts-noto-color-emoji

Quickstart

git clone https://github.com/musyta-labs/orccut && cd orccut
python3 -m venv .venv && .venv/bin/pip install -e .

cp .env.example .env       # MCP_AUTH_ENABLED=false is already set there
.venv/bin/python -m app.mcp.server

The server starts on http://127.0.0.1:8100 — the MCP endpoint is http://127.0.0.1:8100/mcp. The database (SQLite) and media workspace are created on first run.

Or with Docker (ffmpeg, melt and fonts included in the image):

docker build -t orccut .
docker run -p 127.0.0.1:8100:8100 -e MCP_TRANSPORT=streamable-http \
  -v orccut-data:/data orccut

Single-user by design. This build has no accounts: whoever can reach

the port is the operator, with full tool access including local file paths.

Keep it bound to localhost, or put an authenticating reverse proxy in front.

MCPAUTHENABLED=false must be set explicitly — the server refuses to

start otherwise, so an open port is always a decision you made.

Connect an agent

Claude Code:

Shortened. The full README is on GitHub.