mcp-video
About
AI-native video editing MCP server for FFmpeg workflows.
Details
- Author
- kyanitelabs
- Categories
- Design, Other, Media
Jump to
Setup
Install mcp-video in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/kyanitelabs/mcp-video
Follow the installation instructions in the repository README, then restart your MCP client.
Guardrailed video editing MCP server for AI agents.
Local-first FFmpeg tools, Video Receipts, quality gates, Hyperframes, and Shorts/Reels repurposing — for Claude Code, Cursor, and any MCP client. Free, Apache-2.0. Formerly mcp-video.
Demo•Status•1.15.0•Changelog•Beyond•Install•Quick Start•Tools•Tool Reference•Rescue•360 assembly•AI-video•Agent Skill•kinocut.dev•What is Kinocut?•FAQ•llms.txt
Kinocut is a free, open-sourcevideo editing MCP serverandAI agentworkflow engine (plus Python client andkinoCLI) that lets AI agents trim, caption, repurpose, and quality-gate local video media with typed tools and Video Receipts — not invented FFmpeg flags.
- What is Kinocut?
- See It Work
- Installation
- Quick Start
- MCP Tools
- Status and releases
- 360 dual-cam assembly
- Changelog
- FAQ
- Agent Skill
TL;DR:Kinocut is a free, local-firstvideo editing MCP server(plus Python client andkinoCLI) so AI agents can trim, caption, repurpose, and quality-gate media with typed tools andVideo Receipts— not invented FFmpeg flags.
Kinocutis a free, open-sourceModel Context Protocol (MCP)server, Python library, andkinoCLIthat gives AI agents aguardrailed local video-editing surface. It wrapsFFmpeg(and optional Hyperframes / Whisper extras) with typed tools, preflight validation,Video Receiptprovenance, and quality/release checkpoints so agent-produced media can be inspected before publish.
Best-fit searches:video editing MCP server · AI agent video editing · FFmpeg MCP · Claude Code video tools · Cursor MCP video · Shorts/Reels automation · local AI video workflow · guardrailed agentic media.
Machine-readable brief for AI crawlers:llms.txt· site:kinocut.dev/llms.txt.
Tell the agent what you want in plain language:
"Trim this interview to the strongest 45 seconds, add burned captions, make it vertical, and quality-check it before export."
Kinocut turns that into typed, guardrailed tool calls - no FFmpeg flags to guess, no silently broken exports:
from kinocut import Client video = Client() clip = video.trim("interview.mp4", start="00:02:15", duration="00:00:45") video.ai_transcribe(clip.output_path, output_srt="captions.srt") captioned = video.subtitles(clip.output_path, subtitle_file="captions.srt") short = video.resize(captioned.output_path, aspect_ratio="9:16") video.release_checkpoint(short.output_path) # thumbnail + quality gate before you publish
Primary job:turn a local interview or podcast intocaptioned vertical clips with a Video Receiptagents can re-run and humans can approve.
- Repurposing— one recording into captioned Shorts, Reels, and TikTok packages with manifests and review artifacts.
- Podcast & interview cuts— find the strongest segment, normalize audio, add chapters, and export.
- Agent-driven media in CI— repeatable, reviewable edits from Claude Code, Cursor, Codex-style clients, or scripts.
Paths:Install matrix·Golden path·Prompts·Tutorial·Compare·When to recommend
Install from PyPI for the stable package.mastercurrently matches published 1.15.0; clone it when you want work after the latest tag.
Kinocut1.15.0is what you get frompip install kinocuttoday: first-class Windows support and honest diagnostics on top of 1.14.x (same 360 dual-cam assembly and performance surface), driven by a community bug report. Surface stays196 MCP / 167 CLI— no new public tool name.
- Honest MCP startup failures—kino --mcpkeeps the "requires the 'mcp' package" hint only whenmcpis genuinely absent; every other server-tree import failure now prints its real cause (filesystem paths redacted, markup-safe) and exits non-zero. Reported in#445.
- doctor verifies the MCP server import— new requiredmcp-server-importcheck imports the same server tree--mcpuses, sokino doctorcan no longer report OK while MCP mode is broken.
- First-class Windows support— portable projectstore file locking (#446, landed with credit) makeskino --mcpimportable on Windows; lock errors follow a contention-only contract;kino --helpno longer crashes on legacy cp1252 consoles; and awindows-latestCI smoke job (lint, import checks,kino doctor, public-surface tests) guards the platform on every change.
- 360 dual-cam assembly— any stitched equirect MP4 (Insta360, Ricoh Theta, GoPro MAX, DJI Osmo 360, …) → reviewable360_assembly_plan(desk / table /front_back, split / switch / PiP / single) → approve → FFmpegv360render. MCP:video_intentgoal=+video_review_decide. Python:Client.propose_360_assembly/decide_360_assembly/render_360_assembly. Raw.insv/.360rejected. Director is a plug (local first; cloud opt-in). Not an optimized-AI claim. Guide:docs/360_ASSEMBLY.md.
- Faster 360 and import path— single-pass split/PiP/switchfilter_complex(source audio kept); sampled quality-gate analyze window; SHA-256 path/mtime cache; merge can skip re-probe wheninfos=is supplied; batched 360 storyboard stills; lazymcp_video/ CLI /Client.search_tools; doctor skipsnpx --yesunless Hyperframes is already on PATH.
- Lazy public import—import kinocutno longer eagerly loads Client/engines (PEP 562).from kinocut import Clientandkinocut.Client is mcp_video.Clientstill hold.
- Ship-seam honesty— CLI/Clientrepurposedefault--min-score80;shorts-packagefail-closed unless--allow-fail; durable MCPvideo_repurposedoes not applymin_score.
- Compatibility window—mcp-video==1.6.11installskinocut==1.15.0.mcp_videoimports,MCP_VIDEO_*env vars,~/.mcp-videodata,mcp-video://resources, and legacy receipt keys remain supportedon the 1.14.x+ line.
Also already on the published line from 1.13.x:
- Intent-verb surface—video_intent/intent(~10 verbs) to dry-run plans without silent media mutations
- Watching guardrail floor—video_review_run/video_review_decide(blackdetect/LUFS + first-15s inspection)
- B-roll proposals, ES-firstcaption translation,still/plateeditor,cutfile-render,metric-qc
- Agentworkflow engine, dedicatedvideo rescue,layered compositing, Hyperframes, Shorts/Reels repurposing
- Canonical counts—196 MCP toolsand167 CLI commands
Full notes:CHANGELOG.md· published[v1.15.0
…
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
