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 分