← Back to directory
K

Kinocut

Community
Guardrailed video editing MCP server for AI agents
GitHub source repository ↗
★ 141 Stars Category · Other Very popular
66FMRS · C

Kinocut is a local-first, Apache-2.0 video editing MCP server that wraps FFmpeg in typed tools with preflight guardrails, Video Receipts, and quality/release checkpoints, letting AI agents trim, caption, repurpose, and quality-gate media on the local machine. Its clear strengths are being free, account-free, and local so media stays on the user's machine, with an emphasis on inspectable, traceable outputs; the trade-offs are the local FFmpeg requirement (plus Node.js and large optional extras for some features) and the explicit expectation that a human reviews audio and video before publishing. Several README surfaces are labeled unreleased or gated, so check the version and status notes before relying on them.

Reliability
10/20
Security and permissions
11/20
Maintenance
15/20
Documentation
16/20
Setup experience
14/20
Read the FMRS scoring method →

Kinocut (formerly mcp-video) is a free, open-source, local-first Model Context Protocol server, Python library, and kino CLI. It wraps FFmpeg (plus optional Hyperframes and Whisper extras) in typed tools with preflight guardrails, Video Receipt provenance, and quality/release checkpoints, so agents can trim, caption, repurpose, and quality-gate local video media instead of inventing FFmpeg flags. Per the MCP manifest it ships as the PyPI package kinocut over stdio (uvx --from kinocut kino) under Apache-2.0. The README states published 1.15.1 documents 196 MCP tools and 167 CLI commands, while the development tip registers 201 MCP tools and 172 CLI commands. No Kinocut account or API key is needed for the core surface and media is not uploaded to a Kinocut cloud, but FFmpeg must be installed and on PATH. Note: the repository contains 2 MCP servers; this profile covers only the server at server.json.

Tools

video_intent
Express an editing goal as an intent verb and dry-run a plan without mutating media
video_review_run
Run the watching guardrail floor such as blackdetect/LUFS plus a first-15-second inspection
video_review_decide
Record a human decision (approve/reject) on a review plan or 360 assembly plan
video_ingest
Ingest a source asset into a private content-addressed project
video_preflight
Run preflight validation on a stored asset
video_inspect_temporal
Run temporal inspection on a stored asset and produce an evidence package
video_verdict
Write a verdict tied to exact asset identity
video_acceptance_eval
Evaluate acceptance criteria against human evidence
video_body_swap
Perform bounded, audio-preserving derivatives such as body swap
video_salvage
Repair problem regions using allowlisted salvage recipes
video_workflow_validate
Cheap structural gate on a multi-step workflow job-spec, with no render
video_workflow_plan
Dry-run the operation graph and hashes without rendering
video_workflow_render
Execute a multi-step workflow and emit a provenance receipt
video_workflow_inspect
Read-only integrity re-check of a workflow receipt
video_composite_layers
Stack ordered image/video/solid layers with opacity, placement, masks, and blend modes
video_repurpose
Repurpose one source video into vertical, horizontal, and square delivery packages with manifests
video_quality_check
Run a quality check on an output
video_release_checkpoint
Create a release checkpoint with thumbnail and quality gate
search_tools
Discover available operations by keyword without loading every description

Setup

  1. Install FFmpeg and make sure it is on PATH: brew install ffmpeg on macOS, or sudo apt install ffmpeg on Ubuntu/Debian. 2. Install Kinocut: pip install kinocut. 3. Run diagnostics: kino doctor and confirm required checks pass. 4. Register the server with your MCP client. For Claude Code: claude mcp add kinocut -- uvx --from kinocut kino. For Claude Desktop or Cursor, use a config such as {"mcpServers":{"kinocut":{"command":"uvx","args":["--from","kinocut","kino"]}}}. 5. Optionally install extras you use, e.g. pip install "kinocut[transcribe]" for speech-to-text (about 1 GB). Hyperframes tools additionally need Node.js 22+ and a resolvable Hyperframes CLI.
claude_desktop_config.json
{
  "mcpServers": {
    "kinocut": {
      "command": "uvx",
      "args": ["--from", "kinocut", "kino"]
    }
  }
}

Fit and risk

Best for

  • AI agent builders who want local video editing, captioning, repurposing, and quality gating
  • Developers and creators already using MCP clients such as Claude Code or Cursor
  • Local media operators who want typed, guardrailed FFmpeg operations with traceable artifacts instead of guessed flags

Not for

  • Users who want a hosted cloud editor or credit-metered SaaS
  • Users who want an untyped shell wrapper for arbitrary FFmpeg commands
  • Anyone unwilling to install FFmpeg (and optionally Node.js, Whisper, and other extras) locally
  • People expecting to edit raw Insta360 .insv or GoPro .360 files directly — you must export a stitched equirect MP4 from the camera app first

Required permissions

  • Read and write local media files and output directories (editing, exporting, receipts)
  • Execute local FFmpeg/ffprobe subprocesses
  • Read local project/data directories (for example the ~/.mcp-video compatible data dir)
  • Optional: network access for Hyperframes features, website capture, or installing Python extra dependencies
  • Optional: C2PA signing requires c2patool plus a local manifest/signer

Risks and side effects

  • Agents may produce poor or broken video: the README explicitly requires video_quality_check, release checkpoints, and human visual/audio inspection before publishing
  • Risk of overwriting source media: rescue and derivative flows claim the source stays immutable, but you should still back up important footage
  • Optional extras are large (transcribe ~1 GB, stems ~2 GB, upscale ~2 GB), consuming significant disk and install time
  • Depends on a local external toolchain (FFmpeg, plus Node.js 22+ for Hyperframes), so environment drift causes failures
  • Optional capabilities such as website capture, local speech, or AI background removal may involve network access and extra licensing/compliance review
  • Some README surfaces (desktop MCPB packaging, deeper Sonic World Audio integration, the trusted execution kernel, generative spend-cap plans) are gated, partial, or unreleased and should not be treated as stable shipped features

Troubleshooting

  1. Run kino doctor first: it reports exactly which features are available and what is missing
  2. Confirm FFmpeg is installed and on PATH (brew install ffmpeg or sudo apt install ffmpeg)
  3. If MCP startup fails, note that since 1.15.0 the real import cause is printed instead of a vague hint; also check Python 3.11+
  4. Hyperframes tools need Node.js 22+ and a resolvable Hyperframes CLI via PATH or MCP_VIDEO_HYPERFRAMES_COMMAND
  5. Install the matching extra for missing capabilities, e.g. pip install "kinocut[transcribe]" for transcription or kinocut[image] for image analysis
  6. Prove the install with the smallest confidence workflow: python scripts/golden_path.py, or the receipt-backed workflow under workflows/05-confidence-baseline
  7. Upgrading from mcp-video: the mcp_video import, MCP_VIDEO_* env vars, ~/.mcp-video data dir, and legacy receipt keys remain supported on the 1.14.x+ line; new integrations should use kinocut and the kino command

Use cases

Turn an interview or podcast into captioned vertical clips with a Video Receipt an agent can re-run and a human can approve
Repurpose one master clip into YouTube Shorts, Instagram Reels, and TikTok packages with thumbnails, storyboards, and manifests
Podcast and interview cuts: find the strongest segment, normalize audio, add chapters, and export
Drive repeatable, reviewable media workflows from CI or scripts (Claude Code, Cursor, or other MCP clients)
Rescue a damaged clip while keeping story and timeline unchanged: diagnose, approve only safe repairs, render, then verify
Match, grade, and gate multi-still packages with establish-locked color cohesion (still-match, still-grade, still-gate)

Supported clients

Claude CodeFull support
Claude DesktopFull support
CursorFull support