kdenlive-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PATH | No | Executable search path. Pass explicitly if the MCP client starts the server with a reduced environment. | |
| KDENLIVE_MCP_MELT | No | Path or wrapper for the MLT melt executable. | |
| KDENLIVE_MCP_FFMPEG | No | Optional path or wrapper for the ffmpeg executable. | |
| KDENLIVE_MCP_FFPROBE | No | Path or wrapper for the ffprobe executable. | |
| KDENLIVE_MCP_KDENLIVE | No | Path or wrapper for the kdenlive executable, for example an AppImage path. | |
| KDENLIVE_MCP_PROBE_TIMEOUT | No | Seconds allowed for each version probe. | 10 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Local MCP server for Kdenlive projects on Linux. Call diagnose_environment first to check which external programs (Kdenlive, MLT melt, ffprobe) are available on this machine before using project or rendering tools. The server works on local files only and never opens a network listener.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| diagnose_environmentA | Report whether Kdenlive, MLT (melt), ffprobe and ffmpeg are installed and usable, with their paths, versions and actionable hints. Read-only: modifies nothing. Locations can be overridden with KDENLIVE_MCP_KDENLIVE, KDENLIVE_MCP_MELT, KDENLIVE_MCP_FFPROBE and KDENLIVE_MCP_FFMPEG in the server environment. |
| inspect_projectA | Summarize a Kdenlive project file without modifying it: Kdenlive and document versions, profile (resolution, rational frame rate), bin clip count and each timeline sequence with its duration and track counts. Includes the file's sha256 so later calls can detect changes. Reads the file on disk only: unsaved changes in a running Kdenlive are not visible. |
| get_timelineA | Return the tracks, clips, mixes, compositions and guides of one sequence of a Kdenlive project, read-only. Positions are integer frames at the project frame rate; timeline ranges are [start, end) and source in/out are inclusive (see the 'conventions' field). Large timelines are truncated to max_clips. |
| list_project_mediaA | List the media referenced by a Kdenlive project's bin and diagnose missing or unreadable files, plus files used by effects and transitions (LUTs, luma wipes, subtitles). References are resolved exactly like Kdenlive does (project root, moved projects, proxies). Read-only; URLs are reported but never fetched. With probe=true, ffprobe metadata (streams, codecs, sizes, frame rates, rotation) is added for up to 50 available files. |
| probe_mediaA | Check one local media file (absolute path) and return ffprobe metadata: duration, streams, codecs, dimensions, rational frame rate, sample rate, channels, rotation. Read-only; URLs are refused. Probing reads headers and does not prove that every frame decodes. |
| list_render_presetsA | List the render presets of the installed Kdenlive (system and user custom presets), with group and file extension. Use a returned name with render_project. |
| render_projectA | Render a Kdenlive project to a new local file with an installed Kdenlive preset (kdenlive --render), then validate the output with ffprobe. Blocks until the render ends or |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Most tools have clearly distinct roles: environment diagnosis, project summary, timeline detail, media listing, single-file probing, preset listing, and rendering. There is some potential overlap between inspect_project and get_timeline, and between list_project_media and probe_media, but the descriptions clarify the boundaries well.
All tool names use a consistent snake_case verb_noun pattern: diagnose_environment, inspect_project, get_timeline, list_project_media, probe_media, list_render_presets, render_project. The convention is predictable throughout.
Seven tools is well-scoped for a Kdenlive inspection and rendering server. Each tool covers a distinct part of the workflow without obvious redundancy.
The set covers environment diagnosis, project inspection, timeline details, media validation, render presets, and rendering with output validation. It is complete for a read-only inspection/rendering workflow, though it does not support editing or modifying projects.