Videokit

io.github.CloudCorpRecords由 GitHub 帳號 CloudCorpRecords 發布v0.1.0更新於 Nov 7, 2026

Probe, trim, transcode and extract frames or audio from local video files with ffmpeg.

已驗證STDIO僅桌面檔案與儲存媒體與設計

概覽

AI 產生的概覽

本機 stdio MCP 伺服器，透過 ffmpeg 讓助理檢視與編輯本機影片檔：探測、縮圖、擷取影格、擷取音訊、裁剪、轉檔、縮放。

可以做什麼
  • 探測本機影片的長度、解析度、編解碼器與封裝格式
  • 擷取單一縮圖影格、依指定影格率擷取影格，或匯出音軌
  • 將影片裁剪為從某個位移開始的片段、轉檔成其他容器格式，或縮放為指定寬高
  • 把產生的圖片、音訊與影片檔寫入你指定的路徑
適用情境
適合助理需要處理電腦上既有影片檔的情境：剪輯前確認規格、從片段中取出靜態畫面或音訊，或在不使用圖形編輯軟體的情況下產生裁剪、縮放或換容器的副本。
執行需求
以本機程序執行，可透過 npx（npm 套件）或 Docker 啟動；僅限桌面端。主機需自行安裝 ffmpeg 與 ffprobe，因為此套件未內附；Docker 映像內不含 ffmpeg。未宣告任何帳號、API 金鑰或環境變數。
安裝前請注意
工具會將新檔案寫入你指定的輸出路徑，請確認目標位置。處理在本機進行，但大型影片可能耗時且佔用磁碟。Docker 映像因不含 ffmpeg，無法執行依賴 ffmpeg 的工具。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Videokit，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

videokit

Local video file tools as a CLI and a stdio MCP server in one bin. Probe a video for duration, dimensions and codecs; extract a thumbnail, frames or the audio track; trim, transcode and resize.

All work is built as ffmpeg/ffprobe argument arrays (execFile, never a shell string) behind an injectable executor, and probe results are parsed from ffprobe's JSON output — fields a file does not carry come back as null, never invented. This package bundles no ffmpeg: host runs use the host's binaries, and when they are absent the spawn error (ENOENT) is the tool error.

Install

bash
npx -y @reneturcios/videokit mcp

CLI

bash
videokit mcpvideokit 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

Exit codes: 0 success, 1 ffmpeg error, 2 usage error.

MCP tools

ToolPurpose
probe_videoProbe a local video file for duration, dimensions, codecs and format
get_thumbnailExtract a single frame of a video as a thumbnail image file
extract_framesExtract frames of a video as image files in an output directory at a given rate
extract_audioExtract the audio track of a video into an audio file
trim_videoTrim a video to a segment starting at an offset, optionally with a duration
transcode_videoTranscode a video to another container format
resize_videoResize a video to the given width and height

MCP client config:

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

Docker

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

Development

bash
npm installnpm run buildnpm test

MIT license.

來源：README.md，提交 5ea4c54

工具

7

probe_video

Probe a local video file for duration, dimensions, codecs and format

輸入參數file_path必填

get_thumbnail

Extract a single frame of a video as a thumbnail image file

輸入參數file_path必填output_file必填timestamp_seconds

extract_frames

Extract frames of a video as image files in an output directory at a given rate

輸入參數fpsfile_path必填output_dir必填

extract_audio

Extract the audio track of a video into an audio file

輸入參數file_path必填output_file必填

trim_video

Trim a video to a segment starting at an offset, optionally with a duration

輸入參數file_path必填output_file必填start_seconds必填duration_seconds

transcode_video

Transcode a video to another container format

輸入參數format必填file_path必填output_file必填

resize_video

Resize a video to the given width and height

輸入參數width必填height必填file_path必填output_file必填

版本歷史

1
  1. v0.1.0最新Oct 31, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分