Kdenlive 的 MCP 服务器 — 为 Claude Code 及其他 LLM 代理封装 kdenlive-api
概览
Kdenlive 的 MCP 服务器——为 Claude Code 及其他大型语言模型代理封装 kdenlive-api。 通过D-Bus让AI代理对运行中的Kdenlive实例拥有完整的非线性控制权:导入媒体、构建时间线、添加过渡、标记、特效和渲染。 - Python 3.10+ - kdenlive-api - MCP SDK (mcp>=1.0.0) - 运行带有 D-Bus 脚本 API 的补丁 Kdenlive - kdenlive-api — 达芬奇Resolve兼容的Python API- D-Ogi/kdenlive — 带D-Bus脚本API 的Kdenlive分支
概述(AI 翻译)
Kdenlive 的 MCP 服务器——为 Claude Code 及其他大型语言模型代理封装 kdenlive-api。
通过D-Bus让AI代理对运行中的Kdenlive实例拥有完整的非线性控制权:导入媒体、构建时间线、添加过渡、标记、特效和渲染。
快速开始
在你的.mcp.json中添加:
要求
- Python 3.10+
- kdenlive-api
- MCP SDK(
mcp>=1.0.0) - 运行带有补丁的 Kdenlive 和 D-Bus 脚本 API
工具
合成(先用这些)
| 工具 | 描述 |
|---|---|
build_timeline |
场景剪辑的完整汇编(导入 + 序列 + 过渡 + 音频 + 标记) |
replace_scene |
通过编号交换一个场景片段,保持位置和过渡 |
get_timeline_summary |
时间线上所有片段的文本表 |
add_transitions_batch |
批量在轨道上的所有片段之间交叉溶解 |
render_video |
导出时间线到视频文件 |
原子
| 领域 | 工具 |
|---|---|
| 项目 | get_project_info, save_project, load_project |
| 媒体 | get_media_pool, import_media, import_media_glob, create_bin_folder |
本页由 AI 翻译,技术细节请以原文为准。
README
mcp-kdenlive
MCP server for Kdenlive — wraps kdenlive-api for Claude Code and other LLM agents.
Gives an AI agent full NLE control over a running Kdenlive instance via D-Bus: import media, build timelines, add transitions, markers, effects, and render.
Quick start
Add to your .mcp.json:
{
"mcpServers": {
"kdenlive": {
"command": "python",
"args": ["-m", "mcp_kdenlive"]
}
}
}
Requirements
- Python 3.10+
- kdenlive-api
- MCP SDK (
mcp>=1.0.0) - Running patched Kdenlive with D-Bus scripting API
pip install -r requirements.txt
Tools
Composite (use these first)
| Tool | Description |
|---|---|
build_timeline |
Full assembly from scene clips (import + sequence + transitions + audio + markers) |
replace_scene |
Swap one scene clip by number, keep position and transitions |
get_timeline_summary |
Text table of all clips on timeline |
add_transitions_batch |
Batch cross-dissolves between all clips on a track |
render_video |
Export timeline to video file |
Atomic
| Domain | Tools |
|---|---|
| Project | get_project_info, save_project, load_project |
| Media | get_media_pool, import_media, import_media_glob, create_bin_folder |
| Timeline | get_track_list, get_clip_info, insert_clip, append_clips, move_clip, delete_clip, add_track, trim_clip |
| Transitions | add_transition, remove_transition |
| Markers | get_markers, add_marker, delete_marker, delete_markers_by_color |
| Replace | replace_clip |
| Checkpoints | checkpoint_save, checkpoint_restore |
Related repos
- kdenlive-api — DaVinci Resolve-compatible Python API
- D-Ogi/kdenlive — Kdenlive fork with D-Bus scripting API
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手?先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"kdenlive": {
"command": "python",
"args": ["-m", "mcp_kdenlive"]
}
}
}