# opencut-controller

Управляет видеоредактором OpenCut через MCP и Playwright: меняет проекты, таймлайн, медиа, текст и экспорт. Нужен для сценариев видеомонтажа из чата.

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

## Что делает

opencut-controller подключает ИИ-клиент к OpenCut через Playwright. Сервер даёт 161 MCP-инструмент для проектов, сцен, воспроизведения, дорожек, клипов, эффектов, ключевых кадров, медиа, текста, аудио и экспорта. Также доступны ресурсы с текущим состоянием редактора и готовые MCP-промпты.

Подключение работает через `stdio` или HTTP Streamable transport. Для установки нужны `pnpm` или Bun: `pnpm install` ставит зависимости и загружает Chromium для Playwright. Затем скрипт `pnpm run patch-editor ../opencut-classic` патчит локальный редактор, а OpenCut запускается на порту `3001`. Без пропатченного legacy-редактора `OpenCut-app/opencut-classic` контроллер не сможет управлять OpenCut.

Для Claude Code сервер регистрируется командой `claude mcp add opencut-controller -- npx -y opencut-controller`. HTTP-режим использует порт `3002`; для удалённого доступа можно задать `MCP_AUTH_TOKEN`. Временные значения передаются в секундах, громкость элементов измеряется в dB.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

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

**Командой платформы**
```bash
claude mcp add opencut-controller -- npx -y opencut-controller
```

### Codex

**Командой платформы**
```bash
codex mcp add opencut-controller -- npx -y opencut-controller
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "opencut-controller": {
            "command": "npx",
            "args": [
                "-y",
                "opencut-controller"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "opencut-controller": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "opencut-controller"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add opencut-controller npx -y opencut-controller
```

## Когда брать
- создать и сохранить проект OpenCut
- расставить клипы на таймлайне
- добавить текстовые слои и эффекты
- импортировать медиа и настроить звук
- экспортировать монтаж в MP4 или WebM

## Примеры запросов агенту
- Создай проект OpenCut, добавь медиафайлы и размести их на таймлайне.
- Обрежь клип, добавь текстовый слой и подготовь проект к экспорту.
- Экспортируй текущий монтаж в MP4 и проверь состояние таймлайна.

## Похожие
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89433
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [AIHawk](https://affpapa.org/nevibecode/mcp/aihawk.md) — MCP-сервер · ★ 32221
- [Skyvern](https://affpapa.org/nevibecode/mcp/skyvern.md) — MCP-сервер · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/nevibecode/mcp/seleniumbase-mcp.md) — MCP-сервер · ★ 13169
- [Inbox Zero](https://affpapa.org/nevibecode/mcp/inbox-zero.md) — MCP-сервер · ★ 12791

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