KyaniteLabs/kinocut

AI 에이전트를 위한 안전장치(Guardrailed) 비디오 편집 MCP 서버.

로컬 우선 FFmpeg 도구, Video Receipts, 품질 게이트, Hyperframes, 그리고 Shorts/Reels 재활용 — Claude Code, Cursor 및 모든 MCP 클라이언트를 위해. 무료, Apache-2.0. 이전 명칭은 mcp-video.

Demo • Status • 1.15.2 • 1.15.1 • Changelog • Beyond • Install • Quick Start • Tools • Tool Reference • Rescue • 360 assembly • AI-video • Agent Skill • kinocut.dev • What is Kinocut? • FAQ • llms.txt

Kinocut은 무료 오픈 소스 비디오 편집 MCP 서버이자 AI 에이전트 워크플로우 엔진(Python 클라이언트 및 kino CLI 포함)으로, AI 에이전트가 타이핑된 도구와 Video Receipts를 사용하여 로컬 비디오 미디어를 자르고, 캡션을 추가하고, 재활용하며, 품질 검사를 할 수 있게 합니다. 이는 임의로 만들어낸 FFmpeg 플래그가 아닙니다.

• Kinocut이란 무엇인가?
• 작동 방식 보기
• 설치
• 빠른 시작
• MCP 도구
• 상태 및 릴리스
• 360 이중 카메라 조립
• 변경 로그
• FAQ
• 에이전트 스킬

요약: Kinocut은 AI 에이전트가 타이핑된 도구와 Video Receipts를 사용하여 미디어를 자르고, 캡션을 추가하고, 재활용하며, 품질 검사를 할 수 있도록 하는 무료 로컬 우선 비디오 편집 MCP 서버(Python 클라이언트 및 kino CLI 포함)입니다. 이는 임의로 만들어낸 FFmpeg 플래그가 아닙니다.

Kinocut은 AI 에이전트에게 안전장치(guardrailed)를 갖춘 로컬 비디오 편집 표면을 제공하는 무료 오픈 소스 Model Context Protocol (MCP) 서버, Python 라이브러리, 그리고 kino CLI입니다. 이는 FFmpeg(및 선택적 Hyperframes / Whisper 추가 기능)을 타이핑된 도구, 사전 검증(preflight validation), Video Receipt 출처 증명(provenance), 그리고 품질/릴리스 체크포인트와 결합하여 에이전트가 생성한 미디어가 게시되기 전에 검사될 수 있도록 합니다.

또한 알려진 이름 | kino (CLI); 이전 명칭 mcp-video / mcp_video | 최신 공개 릴리스 | 공식 PyPI 버전 · GitHub 릴리스 | 제품 사이트 | kinocut.dev | PyPI | kinocut | MCP Registry | io.github.KyaniteLabs/kinocut | 소스 | GitHub (정식 코드, 이슈, PR, CI 및 릴리스) · Forgejo (하위 미러; 자동 동기화 전환 대기 중) | 라이선스 | Apache-2.0 | 지원 환경 | 사용자의 기기(macOS, Linux, Windows) — PATH에 FFmpeg 필수 | 아님 | 호스팅되는 클라우드 에디터, 크레딧 기반 SaaS 또는 타입이 지정되지 않은 FFmpeg 셸 래퍼

최적 검색어: 비디오 편집 MCP 서버 · AI 에이전트 비디오 편집 · FFmpeg MCP · Claude Code 비디오 도구 · Cursor MCP 비디오 · Shorts/Reels 자동화 · 로컬 AI 비디오 워크플로우 · 보호된(guardrailed) 에이전트 미디어.

에이전트 및 크롤러를 위한 기계 판독 가능 요약: llms.txt

· 확장 에이전트 가이드 · site: kinocut.dev/llms.txt.

에이전트에게 원하는 바를 평이한 언어로 알려주세요:

"이 인터뷰를 가장 강력한 45초로 자르고, 번(burned) 캡션을 추가하고, 세로 형식으로 만들고, 내보내기 전에 품질 검사를 하세요."

Kinocut은 이를 타입이 지정되고 보호된 도구 호출로 변환합니다. 추측할 FFmpeg 플래그도 없고, 조용히 실패하는 내보내기도 없습니다:

from kinocut import Client
video = Client()
clip = video.trim("interview.mp4", start="00:02:15", duration="00:00:45")
...

주요 기능: 로컬 인터뷰나 팟캐스트를 **캡션이 포함된 세로 클립과 비디오 영수증(Video Receipt)**으로 변환하며, 이 결과물은 에이전트가 재실행하고 사람이 승인할 수 있습니다.

사람들이 사용하는 세 가지 용도

재활용(Repurposing)— 하나의 녹화본을 매니페스트와 검토 아티팩트를 갖춘 캡션이 포함된 Shorts, Reels, TikTok 패키지로 만듭니다.팟캐스트 및 인터뷰 자르기(Podcast & interview cuts)— 가장 강력한 세그먼트를 찾고, 오디오를 정규화하며, 챕터를 추가하고, 내보냅니다.에이전트 기반 미디어 CI(Agent-driven media in CI)— Claude Code, Cursor, Codex 스타일 클라이언트 또는 스크립트에서 반복 가능하고 검토 가능한 편집을 수행합니다.

경로: 설치 매트릭스 · 골든 패스 · 프롬프트 · 튜토리얼 · 비교 · 추천 시점

| 표면(Surface) | 버전 / 팁(Version / tip) | 의미(What it means) |
|---|---|
| PyPI / npm 체크포인트(checkpoint) | 1.16.1 (2026-10-05) | 마지막 기록된 출판 체크포인트입니다. 최신 버전은 레지스트리에서 확인하십시오. pip install kinocut으로 설치합니다. |
| GitHub 최신 릴리스 / MCP 레지스트리(Registry) | 1.16.1 | GitHub 릴리스와 초기 출판 작업의 표준 레지스트리 읽기 결과는 1.16.1임을 확인했습니다. 이후 로컬 레지스트리 읽기는 시간 초과되었습니다. 라이브 웹사이트는 마지막으로 1.16.0에서 검증되었으며, 1.16.1 업데이트가 준비되었을 뿐 배포되지는 않았습니다. 최종 소유자 승인 및 플릿(fleet) 롤아웃은 별개입니다. |
| 이 출처 버전(This source version) | 1.16.1 · 203 MCP / 177 CLI | 아래에 설명된 유지보수 수정 사항이 포함되어 있으며, 출판은 docs/public_claims.json에서 별도로 추적됩니다. |
| 다음 공개 릴리스(Next public release) | TBD | 인간 잔여물(디렉토리, 출시 게시물)은 여전히 제한적이며, 추가적인 변경 사항에는 새로운 승인이 필요합니다. |

안정화된 패키지(optional object-matte extra 포함)를 위해 PyPI에서 설치하고, 배포된 패키지를 넘어선 로컬 개발 변경 사항이 필요할 때 master를 클론하십시오. 배포된 object-matte 워크플로우는 docs/PRODUCT_MATTE.md를 참조하십시오.

버전 1.16.1은 macOS 렌더 정리 및 faststart 출판, C2PA 및 model-cache 스테이징, FFmpeg 8.1 필터 검색, 그리고 셰이더/업스케일 재구축에서의 오디오 보존 기능을 수정했습니다. 이 버전은 203 MCP 도구 / 177 CLI 명령어를 유지하며 mcp-video==1.6.16과 함께 사용됩니다.

검증 및 남아 있는 플랫폼/모델 승인 한계는 유지보수 릴리스 노트를 참조하십시오.

2026년 10월 2일 출판: 203 MCP 도구 / 177 CLI 명령어; mcp-video==1.6.15가 설치됩니다.

kinocut==1.16.0을 설치합니다. 연산자 동등성(Operator parity), 제한된 품질/리소스 제어, 표준 소유권 복구에 대한 설명은 릴리스 노트에 나와 있습니다. 라이브 사이트는 1.16.0을 보여줍니다 (2026-10-05 검증). 공유 모바일/웹 처리, 플릿 롤아웃, MCPB 데스크톱 승인 및 최종 교차 표면 소유자 승인은 여전히 별개의 게이트입니다.

Kinocut 1.15.2 버전에서는 검증된 사운드 라인과 적대적 공격에 대비한(adversarial-hardened) 엔진이 탑재되었습니다. 이제 사운드 마스터링은 측정된 마스터링 체인을 통해 스테레오를 보존하며, 실제 캡션-음성 거리 프로파일을 유지합니다. 또한 sound-qa-asr는 실제 인식 요청 없이도 안전하게 실패(fails closed)하도록 개선되었고, 네 개의 보호된 로컬 Revideo 작업이 렌더링 형식 검증과 함께 공개 표면(public surface)에 추가되었습니다. 그리고 release-checkpoint는 CLI를 통해 MCP 릴리스 게이트를 통과합니다. 적대적 감사(adversarial audit)를 통한 보안 강화가 이루어졌습니다: MCP 핸드셰이크가 실제 kinocut 버전을 보고하며, 중앙 가드(central guard)는 작업의 입력값을 별칭으로 사용하는 출력값을 거부하고, 과도한 오류 에코는 잘립니다. 공개 표면은 201 MCP 도구 / 173 CLI 명령어로 확장되었으며, mcp-video==1.6.13 shim이 kinocut==1.15.2를 설치합니다.

Kinocut 1.15.1은 1.15.0을 기반으로 한 유지보수(maintenance) 릴리스입니다: mcp-video 호환성 shim 1.6.12가 레지스트리 소유권 마커를 가지고 있으며, 레거시 io.github.KyaniteLabs/mcp-video 레지스트리 항목이 재게시되어 디렉토리 목록(Glama, PulseMCP)이 활성 메타데이터(#469)를 가리키도록 했습니다. 또한 객체-매트 엔진은 이제 스크래치 디렉터리 캡을 사용하여 디코드를 스트리밍하며, 대용량 입력에 대한 메모리가 제한됩니다(#414). 공개 표면은 196 MCP / 167 CLI로 유지되었으며, 새로운 공개 도구 이름은 없습니다.

Kinocut 1.15.0 (2026-08-19)은 Windows/진단(diagnostics) 릴리스였습니다: 커뮤니티 버그 보고를 통해 1.14.x 기반으로 첫 등급의 Windows 지원과 정확한 진단 기능이 추가되었습니다. 공개 표면은 196 MCP / 167 CLI로 유지되었으며, 새로운 공개 도구 이름은 없습니다.

정확한 MCP 시작 실패: kino --mcp는 mcp 패키지가 실제로 없을 때만

MCP 모드가 손상된 경우 더 이상 OK를 보고할 수 없습니다.Windows 지원 강화— 포터블 프로젝트 스토어 파일 잠금(#446, 크레딧으로 반영됨) 덕분에 kino --mcp가 Windows에서 가져올 수 있게 되었으며; 잠금 오류는 경합(contention)만을 따르는 계약을 따릅니다; kino --help이 더 이상 레거시 cp1252 콘솔에서 충돌하지 않으며; 그리고 windows-latest CI 스모크 작업(lint, import 확인, kino doctor, 공개 인터페이스 테스트)이 모든 변경 사항에 대해 플랫폼을 보호합니다.360도 듀얼 카메라 어셈블리— 스테치된 구형 직사각형 MP4 (Insta360, Ricoh Theta, GoPro MAX, DJI Osmo 360 등) → 검토 가능한 360_assembly_plan (데스크 / 테이블 / front_back, 분할 / 전환 / PiP / 단일) → 승인 → FFmpeg v360 렌더링. MCP: video_intent goal= + video_review_decide. Python: Client.propose_360_assembly / decide_360_assembly / render_360_assembly. 원본 .insv / .360은 거부됩니다. 디렉터는 플러그인(로컬 우선; 클라우드 선택적)입니다. 최적화된 AI 주장으로 간주되지 않습니다. 가이드: docs/360_ASSEMBLY.md.더 빠른 360도 및 가져오기 경로— 단일 패스 분할/PiP/전환 filter_complex (소스 오디오 유지); 샘플링 품질 게이트 분석 창; SHA-256 경로/mtime 캐시; infos=가 제공되면 병합 시 재탐색을 건너뛸 수 있습니다; 배치 360도 스토리보드 스틸 이미지; 지연 로딩 mcp_video / CLI / Client.search_tools; doctor는 Hyperframes가 이미 PATH에 있는 경우가 아니면 npx --yes를 건너뜁니다.지연된 공개 가져오기— import kinocut이 더 이상 Client/engines를 탐욕적으로 로드하지 않습니다 (PEP 562). from kinocut import Client와 kinocut.Client is mcp_video.Client는 여전히 유효합니다.배포-실밥 정직성— CLI/Client의 기본 repurpose --min-score는 80입니다; shorts-package는 --allow-fail이 아니면 실패 시 종료됩니다; 후보 영구 MCP video_repurpose는 작업 성공 전에 min_score를 적용합니다.호환성 창— mcp-video==1.6.14는 kinocut==1.15.3, .mcp_video 임포트, MCP_VIDEO_* 환경 변수, ~/.mcp-video 데이터, mcp-video:// 리소스 및 레거시 영수증 키를 1.14.x+ 라인에서 여전히 지원합니다. 이전 쌍은 mcp-video==1.6.12 → kinocut==1.15.1이었습니다.

또한 이미 1.13.x 버전에서 공개된 라인에 포함되어 있습니다:

의도-동사 표면(Intent-verb surface)—video_intent

/intent`

(약 10개의 동사) 무음 미디어 변형 없이 계획을 건너뛰어 실행하는 시청 가드레일 플로어(Watching guardrail floor)—video_review_run

/video_review_decide`

(blackdetect/LUFS + 첫 15초 검사) B-roll 제안, ES 우선 캡션 번역, 스틸/플레이트 편집기, 컷파일 렌더링, 메트릭 QC(품질 관리)-에이전트
워크플로우 엔진, 전용 비디오 복구, 레이어드 합성(layered compositing), Hyperframes, Shorts/Reels 재활용 1.15.0 릴리스 기준 카운트—196 MCP 도구와 167 CLI 명령어

전체 노트: CHANGELOG.md · PyPI에서 1.16.1로 공개됨

공개된 품질 및 일반 파일 오디오 계약은 품질 증거, 오디오 믹싱 및 프로젝트 저장소 수명 주기(projectstore lifecycle)에 문서화되어 있습니다. 향후 로컬 변경 사항은 Unreleased를 참조하십시오.

공개된 호환성 설치 프로그램 mcp-video==1.6.16은 kinocut==1.16.1을 고정합니다.

플릿(Fleet) 업그레이드 및 실행 프로세스 검증 지침은 docs/FLEET_UPGRADE.md에 있습니다.

2026-10-05 공개 체크포인트는 1.16.1입니다. 초안/게이티드 작업은 공개가 확인될 때까지 릴리스 주장에서 제외됩니다. 라이브 디렉토리 제출 및 출시 게시물은 운영자/인간 잔여분(docs/HUMAN_GATES.md)이며, 완료된 것으로 간주되지 않습니다.

핵심 FFmpeg 편집, 360 어셈블리, 워크플로우 엔진, 스틸/플레이트 편집, AI 비디오 검토/구난(salvage), 그리고 얇은 사운드 결합이 공개된 1.15.x 라인에 통합되었지만, 다음 표면들은 게이티드 상태이거나 부분적이거나 아직 공개되지 않았습니다:

데스크톱 MCPB 패키징: 서명되지 않은 스테이지드 패키지 (mcpb/

)은 user-configured-local-access로 레이블이 지정됩니다. 로컬 Node/Python/Kinocut/FFmpeg가 필요하며, 샌드박스가 아니며, 향후 네이티브 런타임 작업과는 별개입니다. 자세한 내용은 docs/MCPB.md를 참조하십시오.Sonic World Audio (출고된 공개 경계는 여전히 얇은 S12 접합부입니다. S13 패키지와 호스트 접합부는 더 깊은 내부 구조로 존재합니다. 역사적인 7월 S14 수신 기록에는 두 가지 합성 하드웨어 클래스가 기록되어 있는 반면, 나중의 8월 재실행에서는 Apple Silicon과 명시적인 kinocut_sound):external_host_unavailable x86 잔여물이 기록되었습니다. 0.15초짜리 64개 클립은 전체 에피소드나 인간 청취 승인이 아닌 경계가 정해진 배관을 증명합니다.Trusted Execution Kernel: 보호된 타임라인 신뢰 실행 커널은 프로그램/게이트가 적용되며, 명시된 상위 계약과 인간의 게이팅 없이는 실행되지 않습니다 (docs/plans/2026-07-09-kinocut-trusted-execution-layer.md).Generative Plans and Local Caption Speech: 생성형 지출 한도(spend-cap) 및 레거시 TTS 후보 기록은 여전히 실행 불가능한 계획입니다. 설치된 eSpeak NG 엔진을 통해 해시된 sound_voice_batch 요청으로 실제 EN/ES 스톡 자막 음성을 렌더링하고 혼합을 위해 오디오를 유지할 수 있습니다. 자막 음성은 텍스트를 번역하거나 신경망 음성 품질을 약속하지 않습니다. 생성 어댑터가 존재하지 않으며, 자격 증명이나 발견만으로는 실행이 확립되지 않습니다.Product / object matte: 기존의 hyperframes-remove-background 명령어에서 카탈로그 및 쇼핑 커팅아웃(--model birefnet-general, 선택적 추가 kinocut[object-matte])을 사용합니다. 기본값은 사람입니다. 새로운 MCP/CLI 이름이 아닙니다. 1.16.1에 게시되었으며, 1.15.1에서 처음 출고되었습니다 (스트리밍 디코드 + 임시 자막, #414); ONNX 추가 기능은 kinocut[object-matte]를 통해 설치됩니다. 가이드: docs/PRODUCT_MATTE.md. 제품 체크리스트: ROADMAP.md.