mcpField
K
Kodecz

Kodecz

本地服务
github.com媒体与设计3今天更新
代码仓库访问官网

关于 Kodecz

Kodecz 是开源引擎及 MCP 服务，可在 NVIDIA GPU 或 CPU 上将网页渲染为 MP4 视频。它为视频制作者和 Agent 提供渲染、查看画面及自动检查工具。

主要功能

  1. 01将视频文件夹渲染为 MP4
  2. 02以 PNG 图像预览指定帧
  3. 03检查文字位置和字幕长度
  4. 04检查安全区域、对比度和缩放时机

适用场景

  1. 01将网页视频项目渲染为 MP4
  2. 02在视频迭代时检查画面
  3. 03自动发现布局和可读性问题

MCP 相关

MCP 服务向 MCP 客户端提供 Kodecz 的 render、preview 和 check 命令作为工具。它会调用主机上已安装的 `kodecz` 命令。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "konecz-kodecz": {
      "command": "npx",
      "args": [
        "-y",
        "kodecz-mcp"
      ],
      "env": {
        "KODECZ_BIN": "<KODECZ_BIN>"
      }
    }
  }
}
启动命令npx -y kodecz-mcp
需要配置的环境变量
KODECZ_BINPath to the kodecz command (default: kodecz on the PATH)

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

安装包
npmkodecz-mcp0.1.0

工具

3

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

参数类型必填说明
idstring是页面中 <script type="application/json" id="kodecz"> 块内的 id
cpuboolean否即使有 GPU，也在 CPU 上渲染。
frominteger否要渲染的第一帧
hevcboolean否使用 HEVC 而非 H.264（仅限 GPU）
alphaboolean否将透明图层作为带 alpha 的原始 HEVC 渲染（仅限 GPU，无音频）
folderstring是视频文件夹（包含 index.html 的文件夹），可以是绝对路径，也可以是相对于工作目录的路径
framesinteger否从 `from` 开始渲染的帧数
outputstring是输出文件（.mp4；带 Alpha 通道的 .hevc）

详细介绍

kodecz-mcp

适用于 Kodecz 的 MCP 服务。Kodecz 是一个开源引擎，可在 NVIDIA GPU 或任意 CPU 上将网页渲染为 MP4。它为任何 MCP 客户端提供 Kodecz 工作流中的三个命令：

工具功能
render将视频文件夹渲染为 MP4（cpu、hevc、alpha、from、frames）；返回渲染结果的 JSON 行
preview将指定帧绘制为无损 PNG 并作为图像返回，供 Agent 查看
check对每一帧运行自动检查（文字是否覆盖人脸、字幕是否为单行、安全区域、对比度、缩放时机）；返回 JSON 结果及问题图片

此服务没有依赖项。它会运行机器上已安装的 kodecz 命令（将 KODECZ_BIN 设置为其他路径），并通过参数列表调用，绝不经过 shell，因此必须先安装 Kodecz （快速入门）。

使用

Claude Code：Kodecz 插件会为你启动它（/plugin install kodecz --marketplace konecz/kodecz）。

其他任何客户端（Claude Desktop、Cursor、Codex、VS Code 等）：

{ "mcpServers": { "kodecz": { "command": "npx", "args": ["-y", "kodecz-mcp"] } } }

从克隆目录运行，无需 npm："command": "node", "args": ["/path/to/kodecz/mcp/kodecz-mcp.mjs"]。

工具调用中的路径可以是绝对路径，也可以是相对于服务工作目录的路径。测试：node --test mcp/kodecz-mcp.test.mjs。

Apache-2.0。由 Konecz 创建。

评论

支持 Markdown

第一次接触 MCP？

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

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