fcp-mcp — MCP-сервер для Claude Code: работа с FCPXML и Final Cut Pro
MCP-сервер для разбора, генерации и правки FCPXML, а также передачи проверенных файлов в Final Cut Pro. Пригодится монтажёрам и вайб-кодерам, которые правят таймлайны из чата.
claude mcp add --env FCP_MCP_OUTPUT_DIR=<FCP_MCP_OUTPUT_DIR> --transport stdio fcp-mcp-final-cut-pro-mcp-server -- uvx fcp-mcpЧто делает fcp-mcp — Final Cut Pro MCP Server
fcp-mcp даёт агенту 97 инструментов в профиле full, разбитых на 14 категорий. Внутри — парсер FCPXML в дерево объектов, транзакционная запись XML, рациональная арифметика таймкодов, анализ темпа и вспышек, генератор проектов, система кукол-персонажей и сравнение таймлайнов A/B. Живым Final Cut Pro управляет отдельный мост на AppleScript, а медиа разбирает обёртка над ffprobe.
Профиль выбирается переменной FCP_MCP_PROFILE. По умолчанию стоит workflow: 34 инструмента, которые ведут правку по цепочке «проверить → подготовить → просмотреть → подтвердить хеш → зафиксировать». Профиль inspect даёт 30 инструментов только для чтения, edit — 76 с прямой офлайн-правкой, full — 97. Живое управление Final Cut Pro включается отдельно через FCP_MCP_ENABLE_LIVE_CONTROL=1, и выбор full этого права не даёт.
Нужен Python 3.10+, macOS 15.6 или новее с установленным Final Cut Pro. Для инструментов media_* понадобится FFmpeg в $PATH — без него они не заработают. Apple Compressor нужен только для compressor_*. Проверить готовность можно командой fcp-mcp doctor: код выхода 0 означает готовность, 1 — деградацию необязательных возможностей, 2 — блокировку обязательного поведения.
Какие задачи решает
- найти и починить вспышечные кадры в
hero.fcpxml - сгенерировать проект и таймлайн из кода
- сравнить две версии таймлайна и увидеть расхождения
- проверить структуру FCPXML до передачи в монтаж
- собрать отчёт по качеству клипов, ролей и маркеров
Примеры запросов агенту
- Найди вспышечные кадры в
hero.fcpxmlи подготовь исправление - Покажи разницу между двумя версиями таймлайна
- Сгенерируй проект из плана клипов и проверь его структуру
Как установить fcp-mcp — Final Cut Pro MCP Server
Командой платформы
claude mcp add --env FCP_MCP_OUTPUT_DIR=<FCP_MCP_OUTPUT_DIR> --transport stdio fcp-mcp-final-cut-pro-mcp-server -- uvx fcp-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fcp-mcp <команда>
Командой платформы
codex mcp add fcp-mcp-final-cut-pro-mcp-server --env FCP_MCP_OUTPUT_DIR=<FCP_MCP_OUTPUT_DIR> -- uvx fcp-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fcp-mcp <команда>
Файл настроек
{
"mcpServers": {
"fcp-mcp-final-cut-pro-mcp-server": {
"command": "uvx",
"args": [
"fcp-mcp"
],
"env": {
"FCP_MCP_OUTPUT_DIR": "<FCP_MCP_OUTPUT_DIR>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fcp-mcp <команда>
Файл настроек
{
"servers": {
"fcp-mcp-final-cut-pro-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"fcp-mcp"
],
"env": {
"FCP_MCP_OUTPUT_DIR": "<FCP_MCP_OUTPUT_DIR>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fcp-mcp <команда>
Командой платформы
gemini mcp add -e FCP_MCP_OUTPUT_DIR=<FCP_MCP_OUTPUT_DIR> fcp-mcp-final-cut-pro-mcp-server uvx fcp-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fcp-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о fcp-mcp — Final Cut Pro MCP Server
Как установить fcp-mcp в Claude Code?
Добавьте сервер командой claude mcp add fcp-mcp -- uvx fcp-mcp, затем проверьте подключение через claude mcp list или /mcp внутри Claude.
Что делает fcp-mcp?
Разбирает, генерирует и транзакционно правит FCPXML, анализирует медиа и по желанию передаёт проверенные файлы в Final Cut Pro. По умолчанию прямая правка не выполняется.
Что нужно для работы fcp-mcp?
Python 3.10+, macOS 15.6 или новее с Final Cut Pro. Для инструментов media_* нужен FFmpeg в $PATH, для compressor_* — Apple Compressor.
