# Kdenlive MCP Server

MCP-сервер, через который ИИ-агент собирает проект Kdenlive: импорт клипов, таймлайн, фильтры, переходы и рендер через melt.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Автор: Va1bhav512
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Va1bhav512/kdenlive-mcp-server
- Обновлён: 2026-10-14
- HTML: https://affpapa.org/nevibecode/mcp/kdenlive-mcp-server

## Что делает

Сервер оборачивает библиотеку `cli-anything-kdenlive` и отдаёт агенту набор инструментов для работы с проектом Kdenlive. Вызовы идут не через подпроцессы, а напрямую по Python API, поэтому состояние сессии живёт между вызовами: поставили клип на таймлайн — следующий инструмент уже видит его на месте. После каждой правки проект сохраняется сам.

Инструменты разбиты по группам: проект, корзина, таймлайн, фильтры, переходы, метки, экспорт и сессия. Есть пакетная сборка из сегментов — `timeline_build_from_segments` раскладывает несколько оставленных кусков одного клипа подряд за один вызов, и `clip_reframe_vertical` обрезает кадр по центру под вертикальный формат с горизонтальной панорамой. Экспорт умеет отдавать XML и рендерить видео через melt.

Нужен Python 3.10 и выше, а также `uv` для зависимостей. Без установленного `uv` команда запуска сервера не сработает. Для рендера через melt нужен сам melt в системе.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add kdenlive-mcp-server -- uvx kdenlive-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from kdenlive-mcp-server <команда>

### Codex

**Командой платформы**
```bash
codex mcp add kdenlive-mcp-server -- uvx kdenlive-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from kdenlive-mcp-server <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kdenlive-mcp-server": {
            "command": "uvx",
            "args": [
                "kdenlive-mcp-server"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from kdenlive-mcp-server <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "kdenlive-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "kdenlive-mcp-server"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from kdenlive-mcp-server <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add kdenlive-mcp-server uvx kdenlive-mcp-server
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from kdenlive-mcp-server <команда>

## Когда брать
- собрать черновой монтаж из длинной записи, оставив только нужные куски
- перевести горизонтальный клип в вертикальный кадр для соцсетей
- наложить фильтр или переход на клип без ручной работы в редакторе
- выгрузить проект в XML или отрендерить его через melt
- откатить неудачную правку по истории сессии

## Примеры запросов агенту
- Создай проект `my_project.kdenlive-cli.json` с профилем `hd1080p30` и импортируй `video.mp4`
- Собери таймлайн из сегментов клипа `clip0`: с 0.5 по 1.5 и с 3.0 по 4.5 секунды
- Обрежь клип `clip0` под вертикальный формат и отрендери проект

## Похожие
- [cli-anything-kdenlive](https://affpapa.org/nevibecode/skills/cli-anything-kdenlive.md) — скилл · 536 установок
- [yandex-lavka-mcp](https://affpapa.org/nevibecode/mcp/yandex-lavka-mcp.md) — MCP-сервер · ★ 25
- [mcp-builder](https://affpapa.org/nevibecode/skills/jezweb-mcp-builder.md) — скилл · 1400 установок
- [reddit-research-mcp](https://affpapa.org/nevibecode/mcp/reddit-research-mcp.md) — MCP-сервер · ★ 257
- [D365FO MCP Server](https://affpapa.org/nevibecode/mcp/d365fo-mcp-server.md) — MCP-сервер · ★ 40
- [Kapruka MCP](https://affpapa.org/nevibecode/mcp/kapruka-mcp.md) — MCP-сервер · ★ 21

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md