mcp-video

Kinocut

AI エージェント向けのガードレール付き動画編集 MCP サーバー。
ローカル優先の FFmpeg ツール、Video Receipts、品質ゲート、Hyperframes、Shorts/Reels 向けの再編集に対応 — Claude Code、Cursor、あらゆる MCP クライアントで利用できます。無料、Apache-2.0。旧称 mcp-video。

デモ • ステータス • 1.16.5 • 1.16.4 • 1.16.3 • 1.16.2 • 1.16.1 • 変更履歴 • 今後の予定 • インストール • クイックスタート • ツール • ツールリファレンス • レスキュー • 360 度映像の組み立て • AI 動画 • エージェントスキル • kinocut.dev • Kinocut とは？ • FAQ • llms.txt

Kinocut は無料のオープンソース 動画編集 MCP サーバーであり、AI エージェント向けのワークフローエンジンです（Python クライアントと kino CLI も付属）。AI エージェントが型付きツールと Video Receipts を使ってローカル動画メディアをトリミング、字幕付け、再編集し、品質チェックできるようにします。根拠のない FFmpeg フラグを作り出すことはありません。

目次

• Kinocut とは？
• 動作デモ
• インストール
• クイックスタート
• MCP ツール
• ステータスとリリース
• 360 度デュアルカメラ映像の組み立て
• 変更履歴
• FAQ
• エージェントスキル

---

Kinocut とは？

要約： Kinocut は、無料でローカルファーストな動画編集 MCP サーバー（Python クライアントと kino CLI も含む）です。AI エージェントが、型付きツールとVideo Receiptを使って、メディアのトリミング、字幕追加、再利用、品質チェックを行えます。FFmpeg のフラグを推測する必要はありません。

Kinocut は、無料のオープンソースの**Model Context Protocol (MCP) サーバー**、Python ライブラリ、および**kino CLIです。AI エージェントにガードレール付きのローカル動画編集環境**を提供します。FFmpeg（およびオプションの Hyperframes／Whisper 拡張機能）を、型付きツール、事前検証、Video Receiptによる出所情報、品質チェックとリリースのチェックポイントでラップし、エージェントが生成したメディアを公開前に確認できるようにします。

別名	kino（CLI）；以前の名称は mcp-video ／ mcp_video
最新の公開リリース	公式 PyPI バージョン · GitHub リリース
製品サイト	kinocut.dev
PyPI	kinocut
MCP Registry	tech.kyanitelabs/kinocut
ソース	GitHub（正規リポジトリ） · Forgejo（下流ミラー）
ライセンス	Apache-2.0
動作環境	お使いのマシン（macOS、Linux、Windows）— PATH 上に FFmpeg が必要です
該当しないもの	ホスト型クラウドエディター、クレジット制の SaaS、型付けされていない FFmpeg シェルラッパー

相性の良い検索キーワード： 動画編集 MCP サーバー · AI エージェントによる動画編集 · FFmpeg MCP · Claude Code 動画ツール · Cursor MCP 動画 · Shorts／Reels 自動化 · ローカル AI 動画ワークフロー · ガードレール付きエージェント型メディア。

エージェントとクローラー向けの機械可読な概要：llms.txt · エージェント向け詳細ガイド · サイト：kinocut.dev/llms.txt。

プロデューサースタック

Kinocut はプロデューサースタックです。ソースを確認し、型付き操作を選び、ローカルでレンダリングし、簡潔な出所情報レシートを受け取り、品質チェックを実行して、人間によるリリース承認を求めます。デフォルトの MCP インターフェースはこの流れをシンプルに保ち、必要に応じて search_tools とプロファイルで拡張できます。

目を使わずに操作できる設計原則

すべてのフローは、言葉で説明、報告、承認できなければなりません。レシートは、アーティファクトのパス、各段階のステータス、警告、次のチェックポイントを示す、1 画面に収まるテキストカードにします。エラーには、再試行に使う正確な MCP および CLI の呼び出しを記載します。視覚的な操作要素は必要ありません。

動作を確認する

エージェントに、自然な言葉で希望を伝えてください。

「このインタビューから最も良い 45 秒を切り出し、焼き込み字幕を追加して縦型にし、書き出す前に品質チェックしてください。」

Kinocut はそれを、型付きでガードレール付きのツール呼び出しに変換します。FFmpeg のフラグを推測する必要も、気付かないうちに書き出しに失敗することもありません。

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

主な用途： ローカルのインタビューやポッドキャストを、エージェントが再実行でき、人間が承認できるVideo Receipt 付きの字幕入り縦型クリップに変換します。

よく使われる 3 つの用途

• 再利用 — 1 つの録画から、マニフェストとレビュー用アーティファクトを含む、字幕入りの Shorts、Reels、TikTok 向けパッケージを作成します。
• ポッドキャストとインタビューの編集 — 最も良い区間を見つけ、音声を正規化し、チャプターを追加して書き出します。
• CI でのエージェント駆動メディア処理 — Claude Code、Cursor、Codex 形式のクライアント、またはスクリプトから、再現可能でレビュー可能な編集を行います。

各種リンク： インストール方法一覧 · 基本フロー · プロンプト · チュートリアル · 比較 · 推奨する場合

ステータスとリリース

サーフェス	バージョン／先端	意味
PyPI / npm チェックポイント	1.16.5 (2026-10-27)	最後に記録された公開チェックポイントです。最新バージョンはレジストリで確認してください。pip install kinocut でインストールできます。
GitHub 最新リリース／MCP Registry	1.16.5	GitHub リリース v1.16.5 と公式 MCP Registry（tech.kyanitelabs/kinocut、ローカルの uvx kinocut stdio パッケージ）は、1.16.5 を報告しています（2026-10-27 に検証済み）。最終的なオーナー承認とフリートへの展開は別途行われます。
このソースのバージョン	1.16.5 公開済み · デフォルト MCP 20 個／全 205 個／CLI 177 個	QoL の改善：厳選したデフォルト MCP ツール 20 個のリスト（KINOCUT_TOOLS=all で全 205 個のツールカタログを復元）、リトライを考慮したエラー、1 回の呼び出しで完結するショート動画作成、遅延起動。テレメトリー、ネットワーク、上書きのデフォルト設定に変更はありません。公開された mcp-video==1.6.20 はこのランタイムを固定します。検証内容は docs/public_claims.json に記録されています。
次回の公開リリース	TBD	人手が必要な残作業（ディレクトリ、リリース告知の投稿）は保留されています。さらなるバージョン更新には新たな承認が必要です。

安定版パッケージは、オプションのオブジェクトマット追加機能を含め、PyPI からインストールしてください。公開済みパッケージに含まれないローカル開発の変更が必要な場合は、master をクローンしてください。公開済みのオブジェクトマットワークフローについては、docs/PRODUCT_MATTE.md を参照してください。

1.16.5 の内容

2026-10-27 公開：厳選した デフォルトの MCP 登録 20 個を用意し、KINOCUT_TOOLS=all で MCP ツール 205 個／CLI コマンド 177 個すべてを復元できます。リトライを考慮した、画面を見ずに確認できるエラーペイロード、1 回の呼び出しで完結する video_shorts フロー、読み取り専用の video_doctor 事前チェック、遅延起動に対応しました。オプトインの正確なプローブレポートでは、デコード済みフレーム数と未加工の有理数フレームレートを報告します。mcp-video==1.6.20 をインストールすると kinocut==1.16.5 がインストールされます。Apache-2.0 §4(a)：ライセンステキストが npm tarball と mcp-video 互換パッケージに同梱されるようになりました。公開リリースを参照してください。

1.16.4 の内容

2026-10-24 公開：MCP ツール 203 個／CLI コマンド 177 個。mcp-video==1.6.19 をインストールすると kinocut==1.16.4 がインストールされます。オプションの Kinocut モデル呼び出しは、デフォルトで無効になりました。ホストが選択した画像モデルでローカルフレームを使用してください。スタンドアロンのレガシーアダプターには明示的な許可が必要で、Hermes のルーティングは引き継がれません。ローカルの製品設定から、別個の Anthropic QC ワーカーを有効にすることはできません。

Revideo と Hyperframes のテレメトリーはデフォルトで無効です。テレメトリーが無効な場合、Hyperframes のプレビューには検証済みの CLI 0.8.104 または 0.8.140 が必要です。それ以外のプレビューバージョンと Docker によるレンダリングには、オペレーターの明示的な同意が必要です。これらの制御はネットワークのサンドボックスではありません。既存の上書き保護と保護対象パスの安全対策は引き続き有効です。ビジョンとネットワークポリシーおよび公開リリースを参照してください。

1.16.3 の内容

2026-10-23 公開：MCP ツール 203 個／CLI コマンド 177 個。mcp-video==1.6.18 をインストールすると kinocut==1.16.3 がインストールされます。既存の出力を上書きするには、真偽値の overwrite=true（CLI では --overwrite）を明示する必要があります。既存の非メディア成果物についても、同じ永続ジョブが所有している必要があります。また、エージェントの設定ホームは保護されたままです。所有権の証拠がない古いレシートは、安全側に倒して処理を拒否します。

プロジェクトの作成時に、完了済みの出力先とシンボリックリンクによるリダイレクトを確認します。Python 3.14 の MCP リクエストコンテキストを引き続き利用できます。プラグインにはオプションのネットワークパスが記載され、固定されたサーバー環境でオプションの追加機能が設定され、Hermes のツールフィルタリングが示されています。出力ごとに書き込み元を 1 つにしてください。公開リリースを参照してください。

1.16.2 の内容

2026-10-21 公開：MCP ツール 203 個／CLI コマンド 177 個。mcp-video==1.6.17 は kinocut==1.16.2 をインストールします。create-from-images はフレーム単位で正確に動作するようになり、30000/1001 などの有理数フレームレートと、--list／list_file 入力を受け付けるようになりました。また、すべてのエントリーポイントでフレームレートと画像数の上限を適用します。公式 MCP Registry エントリーは、ローカルの uvx kinocut stdio パッケージとして再公開されました。#616 を提供してくださった @Beritwu に感謝します。公開リリースをご覧ください。

1.16.1 の内容

バージョン 1.16.1 では、macOS のレンダリング後のクリーンアップと faststart 公開、C2PA およびモデルキャッシュのステージング、FFmpeg 8.1 のフィルター検出、シェーダー／アップスケール再構築時の音声保持に関する問題を修正しています。MCP ツール 203 個／CLI コマンド 177 個を維持し、mcp-video==1.6.16 と組み合わせて使用します。検証結果と、プラットフォーム／モデルの受け入れに関する残りの制限については、メンテナンスリリースノートをご覧ください。

1.16.0 の内容

2026-10-02 公開：MCP ツール 203 個／CLI コマンド 177 個。mcp-video==1.6.15 は kinocut==1.16.0 をインストールします。オペレーター間の互換性、上限付きの品質／リソース制御、正規の所有権修正については、リリースノートで説明しています。公開サイトには 1.16.0 が表示されています（2026-10-05 に確認）。モバイル／ウェブ間の共有処理、フリートへのロールアウト、MCPB Desktop の受け入れ、各サーフェスを横断した最終的なオーナー受け入れは、引き続き別個のゲートです。

1.15.2 の内容

Kinocut 1.15.2 では、検証済みのサウンド機能と、敵対的な入力に対する耐性を強化したエンジンをリリースします。サウンドのマスタリングでは、実測に基づくマスタリングチェーンと実際の字幕音声距離プロファイルを用いてステレオを保持するようになり、sound-qa-asr は実際の認識リクエストがない場合にフェイルクローズします。ガード付きのローカル Revideo 操作 4 件が、レンダリング形式の検証とともに公開サーフェスに加わり、release-checkpoint は CLI から MCP リリースゲートを通過します。敵対的監査に基づく強化内容：MCP ハンドシェイクで実際の kinocut バージョンを報告するようになり、中央ガードが操作の入力と同一の出力を拒否し、サイズ超過のエラーエコーを切り詰めます。サーフェスは MCP ツール 201 個／CLI コマンド 173 個に拡大します — mcp-video==1.6.13 の shim が kinocut==1.15.2 をインストールします。

1.15.1 の内容

Kinocut 1.15.1 は 1.15.0 をベースにしたメンテナンスリリースです。mcp-video 互換 shim 1.6.12 に Registry の所有権マーカーが含まれ、従来の io.github.KyaniteLabs/mcp-video Registry エントリーが再公開され、ディレクトリーの一覧（Glama、PulseMCP）が最新のメタデータを参照するようになりました（#469）。また、オブジェクトマットエンジンはスクラッチディレクトリーの上限を設けてデコードをストリーミングするようになり、大きな入力でもメモリー使用量が制限されます（#414）。サーフェスは MCP 196 個／CLI 167 個のままです — 新しい公開ツール名はありません。

1.15.0 の内容

Kinocut 1.15.0（2026-08-19）は、Windows 対応と診断機能のリリースです。コミュニティからのバグ報告を受け、1.14.x（同じ360デュアルカメラのアセンブリ機能とパフォーマンス範囲）を基盤に、Windows の本格サポートと正確な診断を実現しました。公開されている機能数は 196 MCP / 167 CLI のままで、新しい公開ツール名はありません。

• MCP の起動失敗を正確に表示 — kino --mcp は、mcp が本当に見つからない場合に限り「requires the 'mcp' package」というヒントを表示します。それ以外のサーバーツリーのインポート失敗では、実際の原因を表示するようになりました（ファイルシステムのパスは伏せ字にし、マークアップに安全な形式で表示）。終了コードはゼロ以外になります。#445 で報告されました。
• doctor が MCP サーバーのインポートを検証 — 新しい必須チェック mcp-server-import では、--mcp が使用するものと同じサーバーツリーをインポートします。これにより、MCP モードが壊れているのに kino doctor が OK と報告することはなくなりました。
• Windows の本格サポート — ポータブルな projectstore ファイルロック（ #446 、貢献者への謝辞とともに取り込み済み）により、Windows で kino --mcp をインポートできるようになりました。ロックエラーは競合時のみ発生する仕様に統一され、kino --help が従来の cp1252 コンソールでクラッシュしなくなりました。また、windows-latest の CI スモークテスト（lint、インポートチェック、kino doctor、公開機能のテスト）により、変更のたびにプラットフォームを検証します。
• 360デュアルカメラのアセンブリ — スティッチ済みの任意の equirect MP4（Insta360、Ricoh Theta、GoPro MAX、DJI Osmo 360 など）から、レビュー可能な 360_assembly_plan（desk / table / front_back、split / switch / PiP / single）を作成し、承認後に FFmpeg v360 でレンダリングします。MCP：video_intent の goal= と video_review_decide。Python：Client.propose_360_assembly / decide_360_assembly / render_360_assembly。生の .insv / .360 は拒否されます。Director はプラグイン方式です（まずローカルで動作し、クラウドはオプトイン）。最適化された AI であるという主張ではありません。ガイド：docs/360_ASSEMBLY.md。
• 360処理とインポートパスの高速化 — split / PiP / switch に単一パスの filter_complex を使用（ソース音声を保持）；品質ゲートの解析ウィンドウをサンプリング；SHA-256 によるパス／mtime キャッシュ；infos= が指定されていれば merge 時の再プローブを省略可能；360ストーリーボードの静止画をバッチ処理；mcp_video / CLI / Client.search_tools を遅延読み込み；Hyperframes がすでに PATH にある場合を除き、doctor は npx --yes をスキップします。
• 公開インポートの遅延読み込み — import kinocut で Client やエンジンをすぐに読み込まなくなりました（PEP 562）。from kinocut import Client と kinocut.Client is mcp_video.Client は引き続き成立します。
• リリース境界の整合性 — CLI / Client の repurpose はデフォルトで --min-score が 80 に、shorts-package は --allow-fail を指定しない場合に fail-closed になりました。候補となる耐久性のある MCP video_repurpose では、ジョブの成功前に min_score を適用します。
• 互換性の維持 — mcp-video==1.6.11 をインストールすると kinocut==1.15.0 がインストールされます。mcp_video のインポート、MCP_VIDEO_* 環境変数、~/.mcp-video のデータ、mcp-video:// リソース、従来のレシートキーは、1.14.x 以降の系列で引き続きサポートされます。ひとつ前の組み合わせは mcp-video==1.6.10 → kinocut==1.14.1 でした。

また、1.13.x から公開済みの系列に含まれている機能：

• 意図を表す動詞の機能群 — video_intent / intent（約10個の動詞）で、メディアを暗黙に変更せずにプランをドライラン
• 視聴時の最低限のガードレール — video_review_run / video_review_decide（blackdetect / LUFS と冒頭15秒の確認）
• B-roll の提案、ES 優先の字幕翻訳、静止画／プレートエディター、cutfile-render、metric-qc
• エージェントのワークフローエンジン、専用の動画レスキュー、レイヤー合成、Hyperframes、Shorts / Reels 向けの再利用
• 1.15.0 リリース時点の機能数 — 196 MCP ツール、167 CLI コマンド

詳細なリリースノート：CHANGELOG.md · PyPI で公開済みの1.16.5

公開済みの品質およびプレーンファイル音声の仕様は、 品質エビデンス、音声ミキシング、projectstore のライフサイクルに記載されています。公開済みパッケージ以降の今後のローカル変更については、Unreleased を参照してください。

1.16.5 以降（ドラフト／ゲート付き）

公開済みの互換性インストーラー mcp-video==1.6.20 では、kinocut==1.16.5 が固定されています。フリートのアップグレードと実行中プロセスの検証手順については、docs/FLEET_UPGRADE.md を参照してください。

2026-10-27 の公開チェックポイントは 1.16.5 です。公開が確認されるまでは、ドラフト／ゲート付きの作業をリリースに関する主張に含めません。ディレクトリへのライブ投稿とローンチ投稿は、引き続き運用者／人間の残作業です（docs/HUMAN_GATES.md）。完了したとは主張しません。

段階導入中およびゲート付きの機能

コアとなる FFmpeg 編集、360 アセンブリ、ワークフローエンジン、静止画／プレート編集、AI 動画のレビュー／救済、簡易サウンド結合は、公開済みの 1.16.x 系列に統合されています。一方、次の機能は引き続きゲート付き、一部対応、または未リリースです。

• デスクトップ MCPB パッケージング： 署名されていない段階導入パッケージ（mcpb/）には、ユーザー設定のローカルアクセスと表示されています。ローカルの Node/Python/Kinocut/FFmpeg が必要で、サンドボックスではありません。また、将来のネイティブランタイム関連作業とは別のものです。docs/MCPB.md を参照してください。
• Sonic World Audio（kinocut_sound）： リリース済みの公開インターフェースは引き続き簡易な S12 結合です。S13 パッケージとホスト結合は、より深い内部機能として存在します。7 月の過去の S14 レシートには合成ハードウェアクラスが 2 種類記録されています。一方、8 月の後続再実行には Apple Silicon と、明示的な external_host_unavailable x86 の残課題が記録されています。0.15 秒のクリップ 64 本で証明されるのは、範囲を限定した処理の動作であり、エピソード全体の完成でも、人間による試聴承認でもありません。
• 信頼実行カーネル： 保護タイムラインの信頼実行カーネルはプログラム後のゲート付き機能であり、指定された上流コントラクトと人間によるゲート承認なしには実行されません（docs/plans/2026-07-09-kinocut-trusted-execution-layer.md）。
• 生成プランとローカル字幕音声： 生成の支出上限と従来の TTS 候補の記録は、引き続き実行不可のプランです。インストール済みの eSpeak NG エンジンは、ハッシュ付きの sound_voice_batch リクエストを通じて、実際の英語／スペイン語の既成字幕音声をレンダリングし、ミキシング用に音声を保持できます。字幕音声 はテキストを翻訳せず、ニューラル音声品質も保証しません。生成アダプターは存在しません。認証情報や検出だけでは、実行できることの証明にはなりません。
• 製品／オブジェクトマット： 既存の hyperframes-remove-background コマンドを使ったカタログおよびショップ向けの切り抜きです（--model birefnet-general、任意の追加機能 kinocut[object-matte]）。デフォルトは引き続き人物です。新しい MCP／CLI 名ではありません。公開済みの 1.16.5 で利用可能になり、1.15.1 で初回リリースされました（ストリーミングデコード＋スクラッチ領域上限、#414）。ONNX の追加機能は kinocut[object-matte] でインストールできます。ガイド：docs/PRODUCT_MATTE.md。

製品チェックリスト：ROADMAP.md。

エージェントワークフローエンジン

エージェントは、単一の JSON ジョブ仕様から、複数ステップのローカル動画ジョブを計画、検証、レンダリング、復旧、証明できます。MCP（video_workflow_*）、CLI（workflow-*）、または Python クライアント（Client.workflow_*）を通じて操作でき、レンダリングの前後に別のエージェントや人間が信頼できるだけの強固なレシートを生成します。操作は小規模な許可リスト（probe | trim | resize | convert | crop | merge | add_text | composite_layers | burn_in）に限定され、個別ツールが使用する、検証済みの同一エンジン関数に 1 対 1 で対応します。メディア参照はシンボリックで、ワークスペース内に制限されます。すべての処理はフェイルクローズで動作します。

{
  "schema_version": 1,
  "name": "captioned-vertical-short",
  "sources": { "hero": { "path": "input/hero.mp4" } },
  "steps": [
    { "id": "trim-hero", "op": "trim", "inputs": { "src": "@sources.hero" },
      "params": { "start": 0, "duration": 6 }, "output": "@work/hero_trim.mp4" },
    { "id": "vertical", "op": "resize", "inputs": { "src": "@work/hero_trim.mp4" },
      "params": { "width": 1080, "height": 1920 }, "output": "@work/hero_vertical.mp4" },
    { "id": "caption", "op": "add_text", "inputs": { "src": "@work/hero_vertical.mp4" },
      "params": { "text": "Watch this", "position": "bottom-center" }, "output": "@outputs.master" }
  ],
  "outputs": { "master": { "path": "output/final.mp4" } }
}

kino workflow-validate --spec job.json    # cheap structural gate, no render
kino workflow-plan     --spec job.json --save-plan plan.json     # dry-run op graph + hashes
kino workflow-render   --spec job.json --save-receipt receipt.json   # execute + provenance receipt
kino workflow-inspect  --receipt receipt.json    # read-only integrity re-check

レンダリングレシートには、各ステップの入力／出力ハッシュ、再開カーソル、クリーンアップマニフェストが記録されます。パスはすべてワークスペース相対です。

{
  "receipt_kind": "workflow",
  "versions": { "mcp_video": "1.13.2", "ffmpeg": "8.1" },
  "spec_hash": "sha256:be2f3a9b...",
  "steps": [
    { "id": "trim-hero", "op": "trim", "status": "completed",
      "input_hashes": { "src": "sha256:3b976d49..." },
      "output": "work/be2f3a9b-2effedb3/mcp_video_hero_trim.mp4", "output_hash": "sha256:00727499..." },
    { "id": "caption", "op": "add_text", "status": "completed",
      "output": "output/final.mp4", "output_hash": "sha256:8633ad2a..." }
  ],
  "cleanup_manifest": { "cleaned": true, "policy": "clean-on-success" },
  "resume_cursor": { "last_completed_step": "caption", "next_step": null },
  "status": "completed",
  "render_determinism_scope": "spec/input/output hashes are deterministic; rendered bytes may vary across FFmpeg builds"
}

--all-variants を指定すると、1 つの宣言から互いに異なる N 個の出力が生成されます。--resume を指定すると、中間生成物を保持したまま失敗したジョブを続行します（仕様が変更されている場合はフェイルクローズします）。完全なスキーマ、@ref 構文、バリアント、再開、クリーンアップについては docs/WORKFLOWS.md を参照してください。実行可能な仕様は examples/workflows/ にあります。

ガバナンスに基づくAI動画レビュー

Kinocutでは、帰属を明確に保ち、レビュー可能な状態にしておく必要がある、エージェント編集メディア向けに、契約優先の手順を提供しています。

1. ソースを非公開のコンテンツアドレス指定型プロジェクトに取り込みます（video_ingest / video-ingest）
2. 保存したアセットに対して、事前チェックと時間軸の検査を行います（video_preflight、video_inspect_temporal）
3. 正確な人間による証拠を用いて、判定と受け入れ評価を行います（video_verdict、video_acceptance_eval）
4. 範囲を限定した派生物のみを作成します。音声を保持するボディスワップ、または許可リストに登録されたサルベージレシピ（video_body_swap、video_salvage）を使用し、それぞれに系譜と、新たな未承認のレビュースロットを設定します

強制実行やバイパスのフラグはありません。アナライザーの出力だけでは承認できません。古い入力、エイリアス化された入力、保護された入力は、すべてフェイルクローズします。運用ガイド：docs/AI_VIDEO_REVIEW_AND_SALVAGE.md。これらの機能は公開済みの1.15.x系に完全に統合されています。ステータスとリリースを参照してください。

専用の動画レスキュー

ストーリーとタイムラインを変更せずにクリップを修正する依頼には、レビュー優先のレスキューパイプラインを使用します。診断を計画して確認し、安全な修復IDのみを承認してからレンダリングし、検証済みパッケージを確認します。ソースは変更されず、マスターとユニバーサル共有コピーは常に検証されます。オプションのキャプションはサイドカーとして保持されます。CLI、MCP、Python、キャンセル、再開、安定したエラーについては、docs/RESCUE.mdを参照してください。

レイヤー合成

composite-layers / video_composite_layersは、2ショットのオーバーレイプリミティブだけでは足りないエージェント向けに、仕様主導の順序付きレイヤースタックを追加します。画像、動画、単色レイヤー、通常のアルファ合成、レイヤーごとの不透明度、x/y配置、変換によるサイズ変更、タイミングウィンドウ、マスク／マットのアルファソースに対応しています。さらに、キャンバス全体および配置領域のブレンドモード（multiply、screen、overlay、darken、lighten）と、新しいpivot基準点による回転にも対応しています。ドライランの計画と決定論的なlayer_plan v2レシートには、ソース、フィルターグラフ、出力のハッシュが記録されます。

kino composite-layers --spec layers.json --dry-run --save-layer-plan layer-plan.json
kino composite-layers --spec layers.json -o out.mp4 --save-layer-plan layer-plan.json

エージェントがオーバーレイ、マット、ローワーサード、ぼかし背景プレート、プラットフォーム別バリエーションを積み重ねた計画を作成し、レンダリング前にレビューする必要がある場合は、composite-layersを使用します。normal以外のブレンドは、2種類のジオメトリで不透明度とstart／durationウィンドウに対応します。明示的なサイズ指定なしで{0,0}に配置するキャンバス全体、または正の整数のwidthとheightを両方指定し、整数の非負値でキャンバス内に配置する矩形です。RGBブレンドでは、サブサンプリングされたクロマプレーンに色の演算を適用しません。スケール、回転／ピボット、マスク／マット、小数位置、キャンバス外の矩形は引き続き未対応であり、unsupported_blend_geometryでフェイルクローズします。動画レイヤーとマスクは、宣言されたレイヤー開始時点から再生を開始します。ソースとマスクは仕様ファイルのディレクトリ内に置き、メディアを含む共通の親ディレクトリに仕様ファイルを配置してください。出力は動画のみです。

360度デュアルカメラ編集

スティッチ済みのequirect 360 MP4（Insta360、Ricoh Theta、GoPro MAX、DJIなど）は、新しいツール名を使わずに、2カメラの16:9または9:16編集にできます。まずカメラアプリから書き出してください。Kinocutは.insvやGoPro .360のスティッチ処理には対応していません。

from kinocut import Client

video = Client()
plan = video.propose_360_assembly("x4-export.mp4", goal="desk 360 split 9:16")
approved = video.decide_360_assembly(plan, "approve")
video.render_360_assembly(approved, "desk-split.mp4")

エージェントの場合：360度またはデスク／テーブルを目的としたvideo_intentにsource=を指定し、続けてvideo_review_decideを実行します。契約の全容についてはdocs/360_ASSEMBLY.mdを参照してください。

静止画／画像編集

Kinocutでは、複数の静止画を含むパッケージを第一級のメディアとして扱います。計画 → レシート → フェイルクローズゲートという流れで、動画レスキューと同じ安全性を確保します。pip install "kinocut[image]"が必要です。kino doctorを実行して画像スタックを確認してください。

**ワークフロー：**ヒーロープレートを設定 → それに合わせて各ビートを編集 → 共通のWB／露出を一致 → グレーディング（シグナルLUTは任意）→ 一貫性ゲート。

# Image analysis: extract colors, generate palettes, analyze products
kino image-extract-colors product.jpg -n 8
kino image-generate-palette scene.png --harmony triadic
kino image-analyze-product listing.jpg --use-ai

# Still/plate editing: match package to hero, grade, gate
kino still-match --hero establish.png --inputs beat1.png beat2.png --output-dir out/matched
kino still-grade --inputs out/matched/*.png --hero establish.png --output-dir out/graded
kino still-gate  --inputs out/graded/*.png --output-dir out/gate

# Establish-locked edit with plan/receipt (dry-run first)
kino image-edit --source beat.png --reference establish.png \
  --intent "match establish world and light" --output-dir out/edit --dry-run

# Or run the full pipeline in one shot
kino still-package --establish establish.png --beats beat1.png beat2.png --output-dir out/pkg

from kinocut import Client

c = Client()
c.still_match(hero="establish.png", inputs=["a.png", "b.png"], output_dir="out/m")
c.still_gate(inputs=["out/m/a_matched.png", "out/m/b_matched.png"], output_dir="out/g")

still-gateは、輝度のばらつきとシャドウの緑／シアン指標についてフェイルクローズします。各ツールはハッシュとゲインを含むJSONレシートを書き込みます。有料の生成バックエンドはデフォルトで無効です（prefer=edit、allow_paid_gen=false）。詳しいガイド：docs/STILL_PLATES.md。

公開ディスカバリー

Kinocut は、検索エンジンと AI 回答エンジンの両方から見つけやすく、引用しやすいように構築されています。

• 正規の製品 URL：https://kinocut.dev/
• GitHub README と llms.txt：エンティティ情報、インストールコマンド、安全ルールを掲載
• 公式 MCP Registry の tech.kyanitelabs/kinocut レコード
• この README と docs/faq.md の FAQ 回答（回答を先に示し、主張にはバージョンを明記）

Kinocut と生の FFmpeg（およびクラウドエディターとの比較）

	Kinocut	エージェントのシェルで使う生の FFmpeg	一般的なクラウドエディター API
インターフェース	型付き MCP / Python / CLI	自由形式のフラグ	ホスト型 HTTP API
事前チェック	レンダリング前のガードレール	エージェントがフラグを推測	ベンダー固有
来歴	Video Receipts + ハッシュ	場当たり的なログ	ベンダーのダッシュボード
メディアの保存場所	ローカル優先	ローカル	アップロードが必要
基本コスト	無料（Apache-2.0）	無料	従量課金が多い

開発の背景

AI エージェントは FFmpeg コマンドを書けますが、フラグを推測したり、壊れやすい stderr を解析したり、問題のあるメディアを気付かれないまま公開したりする必要はありません。Kinocut は、型付き操作、検査可能なツールのメタデータ、構造化された結果、事前チェックのガードレール、品質チェックポイントを提供します。これにより、シェルコマンドの当てずっぽうに頼ることなく、動画ワークフローを自動化してレビューできます。

AI アシスタントに次の作業をさせたい場合にご利用ください。

• 動画のトリミング、結合、サイズ変更、クロップ、回転、トランスコード、書き出し；
• テキスト、字幕、ウォーターマーク、オーバーレイ、フィルター、フェード、エフェクト、トランジションの追加；
• 音声の抽出、音量の正規化、音声合成、生成音声の追加、波形の作成；
• シーンの検出、サムネイルの作成、ストーリーボードの生成、品質の比較、リリースチェックポイントの作成；
• establish-locked の色調統一に基づく静止画パッケージのマッチング、カラーグレーディング、ゲート処理、または製品画像の色やパレットの分析；
• 映画的なプロジェクトのひな形作成、STYLE_/NEG_ ブロックの読み取り、ストーリーボードの表の解析、ショットプロンプトの展開；
• 新しい Hyperframes プロジェクトの作成、レンダリング済みレイアウトの検査、Web サイトのキャプチャ、ローカル音声の生成、背景の削除、FFmpeg ツールを使った結果の後処理；
• 1 つのソース動画から、マニフェストとレビュー用アーティファクトを含む縦型、横型、正方形のローカル納品パッケージを作成；
• Claude Code、Cursor、Codex 系のクライアント、スクリプト、CI から、再現性のあるメディアワークフローを実行。

インストール

前提条件：FFmpeg がインストールされ、PATH から利用できること。

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

グローバルにインストールせずに実行するには：

uvx --from kinocut kino doctor

または pip でインストールします。

pip install kinocut
kino doctor

Claude Desktop 形式の MCPB インストール向けに、Kinocut にはステージング済みのローカルパッケージ mcpb/ とローカルビルドスクリプトが含まれています。

python3 scripts/build-mcpb.py

この署名なしのユーザー設定によるローカルアクセスパッケージは、正確な Kinocut バージョンを含む既存の Python 環境を起動します。また、ローカルの Node、FFmpeg、ffprobe が引き続き必要です。これはサンドボックスではありません。ネイティブの自己完結型バンドルは、今後の別作業として残されています。docs/MCPB.md をご覧ください。

最終 MP4 の書き出しには、c2patool とマニフェスト／署名者が設定されている場合、オプションでC2PA署名を利用できます。署名はデフォルトでオフになっており、検証の読み取りが成功した場合にのみ signed と報告されます。docs/C2PA_PROVENANCE.md をご覧ください。

Hyperframes ツールには、Node.js 22+ と、解決可能な Hyperframes CLI も必要です。アクティブな Node パッケージレイアウトに Hyperframes をインストールしてバージョンを固定するか、hyperframes を PATH に追加するか、MCP_VIDEO_HYPERFRAMES_COMMAND を設定してください。

追加でどれをインストールすればよいですか？

コアのインストールには、すべての FFmpeg 編集ツールが含まれています。オプション機能は追加パッケージとして提供されます。使うものだけをインストールしてください。

利用したい機能	インストール	追加サイズの目安
音声認識による字幕生成（Whisper）	pip install "kinocut[transcribe]"	約 1 GB（torch）
画像分析（色、レイアウト、コントラスト）	pip install "kinocut[image]"	約 50 MB
ボーカル／楽器のステム分離	pip install "kinocut[stems]"	約 2 GB（torch + demucs）
AI アップスケーリング	pip install "kinocut[upscale]"	約 2 GB（Python ≤3.12）
プロシージャルな音声／音楽ツール	pip install "kinocut[audio]"	約 30 MB（numpy）
すべての AI 機能	pip install "kinocut[ai]"	数 GB

自由に組み合わせられます。例：pip install "kinocut[transcribe,image]"。その後、kino doctor を実行してください。利用可能な機能と不足している機能が正確に報告されます。

mcp-video からのアップグレード

名前変更期間中、Kinocut は従来のインターフェースを維持します。既存のインストール環境は、コードを変更せずにアップグレードできます。

pip install --upgrade 'mcp-video==1.6.20'
pip install --force-reinstall --no-deps 'kinocut==1.16.5'
mcp-video doctor

古い shim インストーラーの記録がある場合、依存関係のチェックに合格しても、アップグレード時に共有実行ファイルが削除されることがあります。正式な再インストールによって所有権が復元されます。ロックされたデプロイでは、意図したリリースのバージョン指定を使い、設定済みの追加パッケージを維持してください。固定バージョンでの手順については、フリートの移行手順を参照してください。

公開済みの mcp-video==1.6.20 は、kinocut==1.16.5 用のメタデータのみの互換インストーラーです。mcp_video のインポート、mcp-video コマンド、MCP_VIDEO_* 環境変数、~/.mcp-video データディレクトリ、mcp-video:// リソース URI、既存のレシートキーは、1.14.x 以降の系列でも引き続きサポートされます。新しい統合では、kinocut、from kinocut import Client、kino コマンドを使用してください。

スペイン語

Kinocut は、AI エージェント向けの動画編集 MCP サーバーです。公開中の最新バージョンは 1.16.5（pip install kinocut、KINOCUT_TOOLS=all で MCP ツール 205 個、デフォルトで 20 個／CLI で 177 個）です。すでにスティッチ済みの equirectangular MP4 からのデュアルカム 360 アセンブリ（.insv は対象外）、PEP 562 による遅延インポート、トリミング、結合、字幕追加、音声ミキシング、エフェクト、コンテンツの再利用（Shorts、Reels、TikTok）に対応する同じ型付き FFmpeg インターフェース、検証可能なレシートを備えたワークフローエンジン、動画の救済、ガバナンスに基づく AI 動画レビュー、レンダリング前のセーフティゲートが含まれます。人間が行う残作業（ディレクトリの作成、起動など）は、完全に対応しているとは主張しません。

要件：FFmpeg をインストールし、PATH から利用できるようにしてください。

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

# Instalación y diagnóstico
pip install kinocut
kino doctor

Claude Code の場合：

claude mcp add kinocut -- uvx --from kinocut kino --mcp

kino doctor は、利用可能な機能と、インストールが必要な機能を報告します。ドキュメントはすべて英語ですが、主なエラーメッセージはバイリンガルです。

クイックスタート

基本の手順（60 秒）

エージェントホストに接続する前に、インストールが正しく動作することを確認してください。

pip install -e .          # or: pip install kinocut
kino doctor               # required checks must pass
python scripts/golden_path.py

成功条件と失敗時の復旧方法については、docs/GOLDEN_PATH.md を参照してください。
共有可能なパック（レシート + 品質 + メディア）：python scripts/generate_golden_pack.py → demo/golden-pack/。

まずレシート付きの検証を試す

このリポジトリをクローンしたディレクトリで、エージェントホストに接続する前に、最小限の信頼性確認ワークフローを実行してください。

uv run --no-project --with kinocut python workflows/05-confidence-baseline/workflow.py
uv run --no-project --with kinocut python workflows/benchmarks/run_confidence_benchmark.py

このワークフローでは、小さなソースクリップを生成し、チェック済みの縦型動画を作成して、品質／リリースのチェックポイント手順を実行し、workflows/05-confidence-baseline/output/video_receipt.json に書き込みます。

検証に関する注記は docs/proofs/ にあります。公開向けのマーケティング上の主張（バージョン、ツール数、URL）は docs/public_claims.json にあり、CI でチェックされます。

Claude Code

claude mcp add kinocut -- uvx --from kinocut kino --mcp

Claude Desktop

{
  "mcpServers": {
    "kinocut": {
      "command": "uvx",
      "args": ["--from", "kinocut", "kino", "--mcp"]
    }
  }
}

Cursor

{
  "mcpServers": {
    "kinocut": {
      "command": "uvx",
      "args": ["--from", "kinocut", "kino", "--mcp"]
    }
  }
}

次に、エージェントに以下を依頼します。

このインタビューを 45 秒の縦型クリップにトリミングし、字幕を映像に焼き込み、音声をノーマライズしてサムネイルを作成し、書き出し前にリリースチェックポイントを作成してください。

エージェントスキル

Kinocut には、公開されているエージェントスキル skills/kinocut/SKILL.md が含まれています。MCP サーバー、CLI、Python クライアントのいずれを使うかをエージェントに選ばせつつ、検査、編集、検証、人によるレビューのワークフローを維持したい場合は、互換性のあるエージェントホストで $kinocut を使用してください。

現在のツールのみを使ったパスベースのショートフォームパッケージ（コマンドの創作や外部への公開はありません）については、skills/kinocut-repurpose/SKILL.md をご覧ください。このスキルは明示的なマーケティングシードです。カーネルを基盤とする持続可能な再利用プロダクトは、引き続き信頼された実行環境のロードマップにあります。

Python クライアント

from kinocut import Client

editor = Client()

clip = editor.trim("interview.mp4", start="00:02:15", duration="00:00:45")
caption_file = "captions.srt"
editor.ai_transcribe(clip.output_path, output_srt=caption_file)
captioned = editor.subtitles(clip.output_path, subtitle_file=caption_file)
vertical = editor.resize(captioned.output_path, aspect_ratio="9:16")
checkpoint = editor.release_checkpoint(vertical.output_path)

print(checkpoint["thumbnail"])
print(checkpoint["storyboard"])

CLI

kino info interview.mp4
kino trim interview.mp4 -s 00:02:15 -d 45
kino video-ai-transcribe clip.mp4 --output captions.srt
kino subtitles clip.mp4 captions.srt
kino resize clip.mp4 --aspect-ratio 9:16
kino video-quality-check clip.mp4
kino repurpose clip.mp4 --platforms youtube-shorts instagram-reel tiktok
kino image-extract-colors product.jpg
kino still-package --establish hero.png --beats shot1.png shot2.png --output-dir out/stills

エージェントにできること

ワークフロー	プロンプトの例
ソーシャルクリップ	「この横向きの録画を、字幕付きの TikTok と YouTube Short にしてください。」
ポッドキャスト制作	「最も魅力的な区間を見つけて、トリミングし、音量をノーマライズして、チャプターを追加し、書き出してください。」
製品デモ	「スクリーンショット、タイトルカード、ナレーションから、短いローンチ動画を作成してください。」
シネマティックなプランニング	「スタイルパックとストーリーボードを作成し、生成用のショットプロンプトを書き出してください。」
品質レビュー	「この2つの書き出しを比較し、サムネイルを作成して、映像や音声の問題を指摘してください。」
バッチ自動化	「このフォルダー内のクリップを、音量をそろえてWeb対応のMP4に変換してください。」
コードで作成する動画	「Hyperframes のコンポジションをひな形から作成して検査し、レンダリングしてから、字幕と透かしを追加してください。」
ローカルでの再利用	「このマスタークリップから、サムネイルとマニフェスト付きの Shorts、Reels、TikTok、YouTube 用素材を作成してください。」
動画の修復	「この破損したクリップを診断し、安全な修復案のみを提示して、承認済みパッケージをレンダリングし、レシートを検証してください。」
統制されたレビュー（開発者向けヒント）	「この書き出しをプロジェクトに取り込み、プリフライトと時間軸の検査を実行し、判定を記録して、破損した区間のみを修復してください。」

MCP ツール

公開版 1.16.5 では、KINOCUT_TOOLS=all を通じて 205 個の MCP ツール／177 個の CLI コマンドを提供します。デフォルトで登録されるのは、厳選された 20 個の MCP コアツールです。KINOCUT_TOOLS=profile:editor を指定すると、エディタープロファイルが選択されます。KINOCUT_TOOLS=profile:editor を指定するとエディタープロファイルが選択され、search_tools を使うと、選択したツール群を変更せずに非表示の操作を見つけられます。以下の表に、カタログ全体のカテゴリをまとめています。

カテゴリ	数	主な機能
基本的な動画編集	32	トリミング、結合、サイズ変更、クロップ、回転、変換、オーバーレイ、字幕、書き出し、クリーンアップ、テンプレート、結合互換性のガードレール
プロジェクトに基づく検査	3	コンテンツアドレス方式の取り込み、統合プリフライト、時間的証拠パッケージ
ガバナンス付き AI 動画	4	正確なアセットの判定、受け入れ評価、音声を保持したボディの差し替え、系譜に紐づいた救済
エージェントのワークフローエンジン	4	複数ステップのジョブの検証、計画、レンダリング、再開、検査と、来歴レシートの生成
専用の修復機能	3	ローカルコンテンツを保持する修復の診断、承認、レンダリング、検証、隔離、再開
修復後の計画	8	セマンティックなタイムライン／クエリ、EDL、視覚変換、復元、合成、自動操縦、明示的な出力
シネマティック制作	4	プロジェクトのひな形、スタイルパックの解析、ストーリーボードの解析、ショットプロンプトの展開
AI 支援メディア	11	文字起こし、シーン検出、アップスケーリング、ステム分離、無音部分の除去、カラーグレーディング
Hyperframes	18	初期化、プレビュー、レンダリング、スナップショット、検査、カタログ、ウェブサイトのキャプチャ、ローカル TTS、文字起こし、背景除去、診断、ベンチマーク、後処理
Revideo	4	固定されたブリッジの実体化、ロック済み依存関係のインストール、プロジェクトのレンダリング、または検証済みレシート付きのローカルジョブ全体の実行
再利用	2	ドライランのマニフェスト、プラットフォーム対応バリエーション、サムネイル、ストーリーボード、リリースチェックポイント
プロシージャルオーディオ	7	生成、作曲、プリセット、エフェクト、シーケンス、生成音声、空間オーディオ、ミックスパラメーターのガードレール
視覚効果	8	ビネット、グロー、ノイズ、走査線、色収差、ルマキー、マスク、シェイプマスク、範囲制限付きフィルターパラメーター
トランジション	3	グリッチ、モーフ、ピクセル化
レイアウトとモーション	6	グリッド、ピクチャーインピクチャー、分割画面、アニメーションテキスト、カウンター、プログレスバー、自動チャプター、レイアウト不一致の警告
分析	8	シーン検出、サムネイル、プレビュー、ストーリーボード、品質比較、メタデータ、波形、リリースチェックポイント
画像分析	3	色の抽出、パレットの生成、商品画像の分析
静止画／プレート編集	5	静止画マッチ、静止画グレーディング、静止画ゲート、画像編集、静止画パッケージ — 一貫性ゲートを備えた、固定済みカラーのマッチング
ディスカバリー	1	search_tools

from kinocut import Client

editor = Client()
matches = editor.search_tools("subtitle")
print(matches["tools"])

全リファレンス：docs/TOOLS.md

Shorts をワンコールで作成するレシピ：video_shorts(input_path, segments, style?) は、選択した範囲をトリミングし、指定されたセグメントテキストに字幕を付け、9:16 のテンプレートを適用して、成果物を 1 つ書き出し、1 つのレシートチェーンを返します。外部への投稿は行いません。

エージェントに安全なワークフロー

自律型エージェント向けの想定手順は、調査、編集、検証を行ってから、リリース成果物のレビューを人間に依頼することです。

from kinocut import Client

client = Client()

print(client.inspect("trim"))

result = client.pipeline(
    [
        {"op": "trim", "input": "source.mp4", "start": "00:01:00", "duration": "00:00:45"},
        {"op": "add_text", "text": "Launch clip", "position": "top-center"},
        {"op": "normalize_audio"},
        {"op": "resize", "aspect_ratio": "9:16"},
        {"op": "export", "quality": "high"},
        {"op": "release_checkpoint"},
    ],
    output_path="final-short.mp4",
)

安全性に関する契約：

• メディアを生成する呼び出しは、出力パスを含む構造化された結果を返します。
• 高リスクの編集経路では、FFmpeg の実行前に事前チェックのガードレールが実行されるようになりました。フィルターの範囲、結合時の互換性、音声ミックスの音量とタイミング、オーバーレイ／ウォーターマーク／クロマの不透明度と類似度、アニメーションテキストのタイミング／はみ出し、グリッド／分割画面の不一致に関する警告が対象です。
• 分析および検出の呼び出しは、構造化された JSON レポートを返します。
• ツールの検出には、search_tools() と Client.inspect() を利用できます。
• 想定外のキーワードエラーは、実行可能な対処法を示す MCPVideoError のガイダンスに変換されます。
• video_quality_check、video_release_checkpoint、および人間による映像／音声の確認を行わずに、エージェントが生成した動画を公開しないでください。
• ガバナンス対象の AI 動画派生物では、保存済みのアイデンティティ、有効な人間の意思決定を示す証拠、およびサルベージやボディスワップのたびに新たなレビュースロットを必須としてください。ガバナンス対象と称して、生の FFmpeg による回避策を使うことは決してしないでください。

変更履歴

未リリースの QoL 改善

• 既定の MCP 登録を 20 ツールに整理しました。KINOCUT_TOOLS=all による全カタログの利用、プロファイル選択、非表示ツールの検出、video_shorts、video_doctor、画面を見ずに再試行できるメッセージ、起動時インポートの遅延、MCP の進捗表示の対象範囲拡大を追加しました。既存のテレメトリー、ネットワーク、上書きの既定値は変更していません。

謝辞

• @Beritwu — #599 で正確なプローブに関する貢献をいただきました。
• @Mimatovitch — #594 で macOS のクリーンアップに関するバグをご報告いただきました。

1.16.5（2026-10-27）：

• 既定の MCP 登録を 20 ツールに整理しました。KINOCUT_TOOLS=all で全カタログを利用でき、205 MCP / 177 CLI に対応します。互換性パッケージ mcp-video==1.6.20 は kinocut==1.16.5 をインストールします。再試行に対応したエラー、1 回の呼び出しでのショート動画作成、video_doctor による事前チェック、遅延起動、オプトイン方式の正確なプローブを追加しました。Apache-2.0 のライセンステキストはすべての配布物に含まれます。

1.16.4（2026-10-24）：

• モデル呼び出しは既定で無効です。ローカルとリモートの権限を明示することで、ローカルの製品分析によってクラウド QC が有効化されないようにしました。
• Revideo と Hyperframes のテレメトリーは既定で無効です。Hyperframes のプレビューと Docker によるレンダリングにはガードを設けました。
• プロバイダーに依存しないホスト画像ワークフローと、正確なネットワーク利用状況の開示を追加しました。203 MCP / 177 CLI に対応します。互換性パッケージ mcp-video==1.6.19 は kinocut==1.16.4 をインストールします。

1.16.3（2026-10-23）：

• 上書きへの明示的な同意、メディア以外の成果物に対する同一ジョブ内での所有権、保護されたエージェントのホームディレクトリ、公開先の固定を追加しました。
• プロジェクトパスのチェック、Python 3.14 の MCP コンテキスト、プラグインのネットワークに関する正確なドキュメント、オプトイン方式の Hermes ツールフィルタリングを完了しました。
• 対応範囲は 203 MCP / 177 CLI のままです。mcp-video==1.6.18 は kinocut==1.16.3 をインストールします。

1.16.2（2026-10-21）：

• 有理数のフレームレート（30000/1001）および --list / list_file 入力に対応した、フレーム単位で正確な create-from-images を追加しました。Python、CLI、MCP でフレームレートと画像枚数の範囲を制限します（@Beritwu、#616 に感謝）。
• 公式 MCP Registry のエントリーを、ローカルの uvx kinocut stdio パッケージとして再公開しました。
• 対応範囲は 203 MCP / 177 CLI のままです。mcp-video==1.6.17 は kinocut==1.16.2 をインストールします。

1.16.1（2026-10-05）：

• メンテナンス修正：macOS のレンダリング後のクリーンアップ（稼働中プロセスの監視、ゾンビプロセスに耐性のある静止状態の確認）と、ディスクリプターに基づいて出力先を固定した際の MOV/MP4 の Fast Start 設定の保持。
• C2PA 署名とオブジェクトマット／FSRCNN モデルのダウンロードは、検証後にのみ、所有権が確認されたステージングファイルを通じて公開されるようになりました。
• FFmpeg 8.1 のフィルター検出、GPU シェーダーおよび Real-ESRGAN による再構成でのソース音声の保持、シェーダー／アップスケールのプローブ失敗時の型付きエラーを追加しました。
• 対応範囲は 203 MCP / 177 CLI のままです。mcp-video==1.6.16 は kinocut==1.16.1 をインストールします。

1.16.0（2026-10-02）：

• MCP／CLI／Python 間でオペレーター経路の同等性を確保（オーディオミキシング、ダッキング／HLS、モーションレシート、360 インテント／レビュー制御、操作見積もり）。永続化された MCP リパーパス品質／チェックポイントポリシーを追加。
• 入力の堅牢性を強化（CLI の plan／review JSON のサイズ上限とネスト上限、明示的な JSON ブール値、重複キーの拒否）。
• Client.record_motion_acceptance、時間軸を考慮した motion_coherence エビデンス、オプトインの Anthropic キーフレームレビュー、構造化された FFmpeg 依存関係に関する注意、Gemini CLI のセットアップ例を追加。
• 対応範囲を 203 MCP / 177 CLI に拡大。mcp-video==1.6.15 で kinocut==1.16.0 がインストールされます。

1.15.3（2026-09-25）：

• 公開リリース：PyPI と npm で 2026-09-30 に検証済み。mcp-video==1.6.14 で kinocut==1.15.3 がインストールされます。対応範囲は 201 MCP / 173 CLI のままです。

1.15.2（2026-09-24）：

• 測定済みのマスタリングチェーンを通じたステレオ音声マスタリングを検証（#523/#525/#526）。実際の字幕音声を距離プロファイルで処理。実際の認識リクエストがない場合、sound-qa-asr はフェイルクローズします（#432）。
• レンダリング形式の検証を追加し、ガードされたローカル Revideo 操作を公開サーフェスに公開（#508）。CLI から MCP リリースゲートを通じて release-checkpoint を実行できます。
• 敵対的入力への堅牢性を強化：MCP ハンドシェイクで実際の kinocut バージョンを報告（F1）、入力と同じ場所を指す出力を中央の自己上書きガードで拒否（F2）、エラーのエコーでサイズ超過の値を切り詰め（F4）。
• 絶対値によるトリム終了位置のセマンティクスを維持（#493）。Windows のドライブパスではプレフィックスを保持（#496）。空または空白のみの ASS 字幕トラックは、空の出力をレンダリングせずフェイルクローズします。
• 対応範囲を 201 MCP / 173 CLI に拡大。mcp-video==1.6.13 で kinocut==1.15.2 がインストールされます。

1.15.1（2026-08-31）：

• レジストリの所有権：mcp-video shim 1.6.12 と旧レジストリへの再公開（#469）。
• スクラッチ領域の上限を設けたオブジェクトマットのストリーミングデコード（#414）。
• mcp-video==1.6.12 で kinocut==1.15.1 がインストールされます。

1.15.0（2026-08-19）：

• MCP 起動失敗を正確に報告 — kino --mcp が実際のインポート原因を報告。パスは伏せられ、マークアップに対応（#448、#445 より）。
• doctor の mcp-server-import チェック — 必須のコアチェック。--mcp が壊れている状態で doctor が OK と報告することはありません（#449）。
• Windows を正式サポート — 移植可能な projectstore ファイルロック（#446）、競合時のみのロック契約、UTF-8 標準入出力、windows-latest スモークジョブ。
• コミュニティ主導のリリース — @gerardoscaglia-creator を貢献者と変更履歴の謝辞に記載。
• mcp-video==1.6.11 で kinocut==1.15.0 がインストールされます。

1.14.1（2026-08-13）：

• 1.14.0 のパッチ：GitHub Lint をグリーンに保つため、レスキューキャンセルに pyright の NoReturn を指定。360 およびパフォーマンスのサーフェスは同じです。
• mcp-video==1.6.10 で kinocut==1.14.1 がインストールされます。

1.14.0（2026-08-13）：

• スティッチ済み equirect MP4 からの 360 デュアルカメラ編集を公開（カメラ非依存で、X4 専用ではありません）。video_intent / Client.propose_360_assembly 経由で利用可能 — 196 MCP / 167 CLI のままです。
• パフォーマンス委員会のトップ10項目を実装：単一パスの 360 filter_complex（音声を保持）、サンプリング QC、遅延インポート、SHA キャッシュ、ストーリーボード静止画の一括処理。
• mcp-video==1.6.9 で kinocut==1.14.0 がインストールされます。

1.13.0（2026-08-07）：

• インテント動詞サーフェス（video_intent / intent）、Watching ガードレールの最低基準（video_review_run / video_review_decide）、B ロール提案（video_propose_broll）、字幕翻訳（ES 優先）（video_translate_captions）、および Trusted execution (TE) の利便性向上機能を追加。
• 公開サーフェスを 196 MCP ツールと 167 CLI コマンドに拡大（標準、テスト、クライアントの各インターフェイス間で完全に同期）。
• 字幕翻訳、ブランドキット、OTIO エクスポートのパス検証を強化。

1.12.0（2026-08-07）：

• フェイルクローズ型の一貫性ゲートを備えた 静止画／プレート編集サーフェス（still-match、still-grade、still-gate、image-edit、still-package）を追加。 1.11.x（2026-07-24）：
• 薄い kinocut_sound S12 公開ジョインアダプター（sound-capabilities、sound-plan-validate、sound-mix-render など）を追加しました。
• テーマ適用後のセキュリティ強化により、ホストの絶対パスが漏えいするのを防ぎ、検出されたすべての操作にフェイルクローズの呼び出しパスを確保しました。

過去のリリースノートの全文はCHANGELOG.mdをご覧ください。または、GitHub Releasesページをご覧ください。

FAQ

Kinocut とは何ですか？

Kinocut は、AI エージェントによる動画編集のための、無料のオープンソース MCP サーバー、Python ライブラリ、および kino CLI です。FFmpeg（およびオプションの Hyperframes／Whisper エクストラ）を、事前チェックのガードレール、Video Receipts、品質チェックポイントとともに利用できます。以前は mcp-video という名前でした。

インストール方法を教えてください。

brew install ffmpeg   # or apt install ffmpeg
pip install kinocut
kino doctor
claude mcp add kinocut -- uvx --from kinocut kino --mcp

無料で、ローカル優先ですか？

はい。Apache-2.0 ライセンスで、お使いのマシン上で動作します。コア機能の利用に Kinocut アカウントや API キーは必要なく、メディアが Kinocut のクラウドにアップロードされることもありません。

ローカルでの計算とストレージには、引き続きコストがかかります。オプションのプロバイダーやホストエージェントから別途課金されることがあり、プロンプトやツールの結果がホストのモデルプロバイダーに送信される場合があります。ローカルで実行するだけでは、データが外部に送信されないことは保証されません。

どのエージェントで使えますか？

ローカルの stdio サーバーを実行できる MCP 互換クライアントであれば、どれでも使用できます（Claude Code、Cursor、Windsurf、Cline など）。エージェントを使わずに、Python クライアントや CLI を利用することもできます。

ツールはいくつありますか？

公開版 1.16.5 では、KINOCUT_TOOLS=all を設定した kino --mcp の tools/list で 205 個の MCP ツール／177 個の CLI コマンドを利用できます。デフォルト登録は、厳選されたコア 20 ツールです。正確なパラメーターは、インストール済みサーバーのツールスキーマを確認してください。search_tools を使うと、非表示の操作を検出できます。

Kinocut で Insta360 X4 の 360 度動画を編集できますか？

はい。.insv ではなく、スティッチ済みの 360 MP4 が対象です。360_assembly_plan を提案して承認した後、分割／切り替え／PiP／単画面でレンダリングします。他のスティッチ済み正距円筒図法カメラでも動作します。docs/360_ASSEMBLY.mdをご覧ください。

mcp-video という名前でしたか？

はい。現在公開されている mcp-video==1.6.20 は kinocut==1.16.5 をインストールします。以前の mcp-video==1.6.19 は kinocut==1.16.4 を、過去の mcp-video==1.6.11 は kinocut==1.15.0 をインストールしていました。互換性のためのインポート、CLI 名、環境変数、データディレクトリ、リソース URI、レシートキーは、1.14.x 以降の系列でも引き続きサポートされます。

Kinocut で Insta360 X4 のファイルを 2 台のカメラによる編集にできますか？

はい。スティッチ済みの 360 MP4 をエクスポートしてから、提案 → 承認 → レンダリングの順に進めます。.insv は拒否されます。この機能は 1.14.1 でリリースされ、公開版 1.16.5 でも引き続き利用できます。

Kinocut はどのような点が異なりますか？

生の FFmpeg スクリプトやガードされていないエージェントのシェルとは異なり、Kinocut はツールを検証し、レシートを出力します。

Kinocut は本番用ソフトウェアですか？

成熟度については、README のステータスとリリースタグを信頼できる情報源として扱ってください。本番環境で使用する前に、ご自身の要件に照らして検証してください。

ほかの回答：docs/faq.md · サイト上の FAQ：kinocut.dev/#faq

ドキュメント

• ドキュメント一覧
• 製品サイト
• ツールリファレンス
• Python クライアントリファレンス
• CLI リファレンス
• エージェントワークフローエンジン
• 動画レシート
• 動画レスキュー
• 360 デュアルカメラ編集
• レスキュー後のプランニング
• AI 動画のレビューとサルベージ
• AI 動画の契約
• AI 動画の検査
• C2PA の来歴情報
• MCPB パッケージング
• 製品ロードマップ
• 信頼できる実行レイヤーの計画
• ウィッシュリスト／1.8 プログラム並行実行計画
• サウンドプログラムの状況
• AI エージェント向け発見ガイド
• よくある質問
• ゴールデンパス（初回実行の検証）
• 公開されている情報（バージョン／件数）
• ゴールデンデモパック
• 変更履歴
• llms.txt

テスト

開発時の検証については、docs/TESTING.mdをご覧ください。ツールの動作を変更する際は、公開インターフェース、メディアワークフロー、セキュリティのチェックを最新の状態に保ってください。

開発

git clone https://github.com/KyaniteLabs/kinocut.git
cd kinocut
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest tests/ -v -m "not slow and not hyperframes"

コミュニティ

• 貢献方法
• 行動規範
• ガバナンス
• メンテナー
• セキュリティ
• サポート
• ロードマップ
• 変更履歴
• GitHub のイシュー

コミュニティによるデプロイ

自宅のルーターのポートを開放せずに公開 MCP URLを利用したい運用者は、Kinocut と Hyperframes を Tailscale Funnel、Caddy、Google OAuth（mcp-auth-proxy）の背後に配置する、コミュニティ提供の Apache-2.0 リファレンススタックを参考にできます。 hyperframes-selfhost （KyaniteLabs とは無関係です。ご自身の脅威モデルに照らしてセキュリティを評価してください）。

ライセンス

Apache 2.0。LICENSEをご覧ください。

FFmpeg、Hyperframes、Model Context Protocolを使用して構築されています。

---

KyaniteLabs の一部

KyaniteLabsのその他のプロジェクトをご覧ください。関連プロジェクト：

• Epoch — AI エージェント向け時間見積もり MCP サーバー（PERT）
• DialectOS — スペイン語の方言ローカライズ用 MCP サーバーと CLI
• checkyourself — AI で構築したコード向けのローカルファーストな本番対応チェック

→ 詳しくは kyanitelabs.tech をご覧ください

---

Kinocut が役に立ったら、GitHub でスターを付けるか、ウォッチしてください — 他のエージェント開発者が見つけやすくなります。 編集時間を大幅に節約できた場合は、こちらから応援できます：ko-fi.com/kyanitelabs。

Simon Gonzalez De Cruz が開発しました — 上記の公開プロフィールリンクから、フォワードデプロイド／応用 AI エンジニアリングおよび業務委託の依頼を受け付けています。

対象ユーザー

• 主な対象：AI エージェントの開発者、Claude Code／Cursor のユーザー、ローカルメディアの運用者
• 型付き FFmpeg ツールを使って動画の編集、字幕付け、再利用、品質チェックを行う必要がある場合にご利用ください
• ホスト型クラウドエディターや、型付けされていない FFmpeg シェルが必要な場合は、別のものをご利用ください

ステータス

• 2026 年時点でデフォルトブランチにてメンテナンス中
• 依存関係を固定する場合は、リリースタグを優先してください
• 問題は正式なGitHub リポジトリに報告してください

エージェント向け情報

• コーディングエージェント：まずこの README を読み、次にリポジトリの docs/／AGENTS.md（存在する場合）を確認してください
• リポジトリに llms.txt がある場合は、機械可読な概要を優先してください
• MCP またはスキルのエントリーポイントは、該当する場合、リポジトリ内のドキュメントに記載されています

コントリビューション

GitHub での Issue や PR を歓迎します。公開ドキュメントには、秘密情報やマシン固有のパスを含めないでください。

コントリビューター

Kinocut は公開の場で改善を続けており、外部からのコントリビューションがその改善を形作っています。1.15.0 の診断機能の修正は、素晴らしいバグ報告から直接生まれました。再現手順と実際のトレースバックを含む報告もコントリビューションです。コントリビューターは、変更履歴の謝辞とリリースノートに名前を記載して紹介しています。

• @gerardoscaglia-creator — Windows の MCP モードに関する調査（#445）により、1.15.0 で修正された診断機能の2つの不足が明らかになりました。また、ポータブルなファイルロックの修正（#446）が謝辞付きで1.15.0に取り込まれました。ありがとうございます。
• @pedropaav-art — Windows でのフィルターオプションのパスエスケープ（#458）。2026-08-18にマージされ、1.15.0でリリースされました。
• @linhaixin45-cmyk — インストール時のヒントを表示する kino doctor の Python バージョン下限（#459）。2026-08-18にマージされ、1.15.0でリリースされました。
• @WohaibHasan — 絶対値でのトリム終了位置の処理（#493）、Windows のドライブ情報の保持（#496）、ポータブルな UTF-8 CLI テストのキャプチャ（#498）。
• @betsmayank — 初めてマージされた外部からの修正：Hyperframes の init が、TTY のない環境で MCP 経由でもハングしなくなりました（#361）。
• @austinwmson と @ismailkattakath — 実際の不足を解消した外部からの報告：remotion_still の実行時 props（#306）と、セルフホスト向け Funnel + OAuth のリファレンス構成（#432）。
• @Dodothereal と @OyaAIProd（アカウントは現在存在しません）— 初期の外部 PR（縦型動画への焼き付け用 ASS PlayRes #378、SafeSkill バッジ）。

クロスプラットフォームアーキテクチャと現在のサポート状況を示す根拠：プラットフォーム間の対応状況。このリリースでは、Web／モバイルで共通の処理機能とネイティブクライアントは実装されていません。