mcpField
V
videokit

videokit

本地服务
github.com/CloudCorpRecords媒体与设计02 周前更新
代码仓库

关于 videokit

videokit 是使用 ffmpeg 和 ffprobe 处理本地视频文件的 CLI 与 stdio MCP 服务，可检查媒体属性，并提取帧、缩略图和音轨，或剪辑、转码及调整尺寸。它依赖主机上已有的二进制文件。

主要功能

  1. 01检查时长、尺寸、编解码器和格式
  2. 02提取缩略图与连续帧
  3. 03提取音轨
  4. 04剪辑视频片段
  5. 05转码及调整视频尺寸

适用场景

  1. 01查看本地视频的技术属性
  2. 02生成缩略图或采样帧
  3. 03提取音频或剪辑片段
  4. 04转换视频格式或尺寸

MCP 相关

stdio MCP 服务提供工具，用于检查本地视频、提取缩略图、帧和音频，以及剪辑、转码或调整文件尺寸。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-videokit": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/videokit"
      ]
    }
  }
}
启动命令npx -y @reneturcios/videokit

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@reneturcios/videokit0.1.0
ocighcr.io/cloudcorprecords/videokit:0.1.0

工具

7

收录的工具列表 · 更新于 2 周前

参数类型必填说明
file_pathstring是要探测的本地视频文件路径。

详细介绍

videokit

将本地视频文件工具打包为一个 CLI 和一个 stdio MCP 服务。 探测视频的时长、尺寸和编解码器；提取缩略图、帧或音轨； 剪辑、转码和调整尺寸。

所有操作都会构建为 ffmpeg/ffprobe 参数数组（使用 execFile， 绝不使用 shell 字符串），并通过可注入的执行器运行。探测结果 会从 ffprobe 的 JSON 输出中解析——文件中不存在的字段会返回 null，绝不会凭空捏造。此软件包不包含 ffmpeg：在主机上运行时 使用主机的二进制文件；若二进制文件不存在，产生的启动错误 （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将视频中的单帧提取为缩略图图片文件
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 许可证。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。