videokit

videokit

CLI と stdio MCP サーバーを1つのバイナリにまとめた、ローカル動画ファイル用ツールです。 動画の長さ、サイズ、コーデックを調べたり、サムネイル、フレーム、音声トラックを抽出したり、トリミング、トランスコード、サイズ変更を行ったりできます。

すべての処理は、注入可能な実行関数の背後で ffmpeg/ffprobe の引数配列として構築されます（execFile を使用し、シェル文字列は使用しません）。また、プローブ結果は ffprobe の JSON 出力から解析されます。ファイルに含まれていないフィールドは null となり、決して捏造されません。このパッケージに ffmpeg は含まれていません。ホスト上で実行する場合はホストのバイナリを使用し、バイナリが見つからない場合は spawn エラー（ENOENT）がツールエラーになります。

インストール

npx -y @reneturcios/videokit mcp

CLI

videokit mcp
videokit probe <file>
videokit thumbnail <file> <output> [timestamp-seconds]
videokit audio <file> <output>
videokit trim <file> <output> <start-seconds> [duration-seconds]
videokit resize <file> <output> <width> <height>
videokit --version

終了コード：0 は成功、1 は ffmpeg エラー、2 は使用方法のエラーです。

MCP ツール

ツール	用途
probe_video	ローカル動画ファイルの長さ、サイズ、コーデック、フォーマットを調べます
get_thumbnail	動画の1フレームをサムネイル画像ファイルとして抽出します
extract_frames	指定したレートで、動画のフレームを出力ディレクトリ内に画像ファイルとして抽出します
extract_audio	動画の音声トラックを音声ファイルに抽出します
trim_video	オフセットから始まる区間に動画をトリミングします。再生時間は任意で指定できます
transcode_video	動画を別のコンテナ形式にトランスコードします
resize_video	指定した幅と高さに動画のサイズを変更します

MCP クライアントの設定：

{
  "mcpServers": {
    "videokit": {
      "command": "npx",
      "args": ["-y", "@reneturcios/videokit", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/videokit          # MCP server (ffmpeg unavailable in-image)
docker run --rm ghcr.io/cloudcorprecords/videokit --version

開発

npm install
npm run build
npm test

MIT ライセンス。