交易式MCP服务器，用于创建、编辑、验证、预览和渲染Shotcut项目。
概览
通过模型上下文协议进行本地视频编辑。 通过你的 AI 助手创建、编辑、验证、预览并渲染已保存的 Shotcut 项目。结果保持可编辑的 .mlt 时间轴，并带有交易写入保护项目，在你工作时保持安全。 一个简短的 H.264 导出，基于 Shotcut 本地时间线，通过 Shotcut MCP 编辑。 https://github.com/user-attachments/assets/c70f064f-17e7-403d-9bcf-689a9c616cdf 你需要 （推荐的，捆绑的 MLT）和一个支持本地 stdio 服务器的 MCP 客户端。Shotcut 包含所需的媒体工具、编解码器和过滤器。不需要额外的 Python 包。 安装指南包含了Windows、macOS和Linux的命令。运行服务器无需安装pip。对于源代码检查，指南还展示了如何在连接MCP前用脚本/shotcut_mcp_server.py--检查检查Python和Shotcut。 运行shotcut_status和shotcut_doctor。报告刀具路径、版本和失败的运行时检查。
概述（AI 翻译）
通过模型上下文协议进行本地视频编辑。
通过您的AI助手创建、编辑、验证、预览并渲染已保存的Shotcut项目。结果保持可编辑的时间线.mlt，并以事务式写入保护项目。
演示 ·快速入门 ·文档 ·网站
演示
一个简短的 H.264 导出，基于 Shotcut 本地时间线，通过 Shotcut MCP 编辑。
https://github.com/user-attachments/assets/c70f064f-17e7-403d-9bcf-689a9c616cdf
快速开始
你需要 Python 3.10+、Shotcut（推荐 26.8.1，捆绑的 MLT 7.41.0），以及支持本地 stdio 服务器的 MCP 客户端。Shotcut 包含所需的媒体工具、编解码器和过滤器。不需要额外的 Python 包。
1.连接你的客户
| 客户 | 安装 |
|---|---|
| Claude桌面 / 兼容MCPB客户端 | 请遵循MCPB安装和更新指南。 |
| Codex | 克隆仓库并注册本地服务器。 |
| Claude 代码 | 运行 /plugin marketplace add matrodrigs/shotcut-mcp，然后是 /plugin install shotcut-mcp@matrodrigs 和 /reload-plugins。详细说明和手动设置。 |
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
Shotcut MCP
Local video editing through the Model Context Protocol.
Create, edit, validate, preview, and render saved Shotcut projects through your AI assistant. The result stays an editable .mlt timeline, with transactional writes that protect the project as you work.
Demonstration · Quick start · Documentation · Website
Demonstration
A short H.264 export created from a native Shotcut timeline edited through Shotcut MCP.
https://github.com/user-attachments/assets/c70f064f-17e7-403d-9bcf-689a9c616cdf
Quick start
You need Python 3.10+, Shotcut (recommended 26.8.1, bundled MLT 7.41.0), and an MCP client that supports local stdio servers. Shotcut includes the required media tools, codecs, and filters. No additional Python packages are required.
1. Connect your client
| Client | Installation |
|---|---|
| Claude Desktop / MCPB-compatible client | Follow the MCPB installation and update guide. |
| Codex | Clone the repository and register the local server. |
| Claude Code | Run /plugin marketplace add matrodrigs/shotcut-mcp, then /plugin install shotcut-mcp@matrodrigs and /reload-plugins. Details and manual setup. |
| Other MCP client | Configure a local stdio server. |
The installation guide includes commands for Windows, macOS, and Linux. No pip install is required to run the server. For a source checkout, the guide also shows how to check Python and Shotcut with scripts/shotcut_mcp_server.py --check before connecting MCP.
2. Check readiness
Ask your assistant:
Run shotcut_status and shotcut_doctor. Report tool paths, versions, and failed runtime checks.
Resolve failed runtime checks before editing. See troubleshooting for recovery steps.
3. Make your first edit
Provide the source folder and the destination for the saved project, then describe your edit:
Create a 1920×1080, 30 fps Shotcut project from every video in this folder.
Put narration on A1, add 12-frame crossfades, and save it as documentary.mlt.
Generate a contact sheet so I can review the edit before exporting.
You can request adjustments in ordinary language. See the editing workflow and example prompts for subtitles, quality analysis, effects, and delivery.
Features
- Edit the timeline: work with tracks, clips, transitions, speed changes, titles, and subtitles; discover source media in a folder and apply up to 500 operations in one transaction.
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →