内容
# Kdenlive MCP
基于模型上下文协议的本地优先视频编辑。Kdenlive MCP 保留了一个版本化的 JSON 项目作为真实来源，应用修订检查的时间线编辑，编译确定性的 MLT，排队渲染，生成预览，并使用您计算机上已有的 Kdenlive/MLT 和 FFmpeg 安装进行输出验证。
> 公共预览：里程碑 0-4 和 7 已实现。本地 AI 分析（里程碑 5）和 Kdenlive/OTIO 往返互操作性（里程碑 6）正在计划中，并明确标记为不可用。
## 功能列表
- 具有原子修订、检查点、撤销和重做的规范项目。
- 媒体导入，具有允许根目录限制和托管/外部模式。
- 视频剪辑放置、链接音频/视频、波纹编辑、属性、关键帧、特效、过渡、文本、字幕和标记。
- 持久的预览/导出作业、进度、取消、重启恢复和有限的工件。
- 输出时长、流、音频/视频同步、响度、剪辑、黑屏和冻结检查。
- 通过标准输入输出或身份验证的环回 Streamable HTTP 进行 MCP。
- 自动 Kdenlive/MLT/FFmpeg 发现和可行的医生命令。
## 快速开始
要求：Node.js 22+，pnpm 9 和 Kdenlive 或独立的 MLT/FFmpeg 工具。
Powershell:
```powershell
git clone https://github.com/AMMIROSOH/Kdenlive-mcp.git
cd Kdenlive-mcp
Set-ExecutionPolicy -Scope Process Bypass
.\scripts\install.ps1 -AddToPath
kdenlive-mcp --doctor
```
Linux:
```sh
git clone https://github.com/AMMIROSOH/Kdenlive-mcp.git
cd Kdenlive-mcp
./scripts/install.sh
~/.local/share/kdenlive-mcp/kdenlive-mcp-*/kdenlive-mcp --doctor
```
然后将 stdio 命令添加到您的 MCP 客户端，并设置绝对允许根目录：
```text
kdenlive-mcp --root /path/to/video-workspace --client-id my-mcp-client
```
参见完整的 [安装和客户端配置指南](INSTALL.md)。
## 安全模型
- 文件仅限于配置的根目录；拒绝符号链接/遍历逃逸。
- 突变需要确切的当前修订版本，并且每个客户端都可以撤销。
- 渲染过程使用参数数组，无 shell，有限输出/时间，限制环境。
- HTTP 仅绑定到环回，并需要生成的 bearer token。
- 此仓库不重新分发 Kdenlive、MLT 和 FFmpeg 二进制文件。
在将服务器暴露给其他软件之前，请阅读 [威胁模型](docs/threat-model.md) 和 [安全策略](SECURITY.md)。
## 文档
- [安装](INSTALL.md)
- [教程](docs/tutorial.md)
- [MCP 参考](docs/mcp-reference.md)
- [架构和数据所有权](docs/architecture.md)
- [运行时支持](docs/runtime-support.md)
- [故障排除](docs/troubleshooting.md)
- [路线图](docs/roadmap.md)
- [贡献](CONTRIBUTING.md)
## 开发
```shell
pnpm install --frozen-lockfile
pnpm check
pnpm doctor
pnpm render:acceptance
pnpm mcp:acceptance
pnpm docs:check
pnpm sbom
pnpm release:acceptance -- --platform windows
```
## 许可证
本仓库使用 Apache-2.0 许可证。外部 Kdenlive/MLT/FFmpeg 安装保留其自身的许可证；请参见 [第三方通知](THIRD_PARTY_NOTICES.md)。
MCP 市场