MS

matrodrigs/shotcut-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

25 stars 4 forks 品質 71 トレンド 31MIT

トランザクション MCP サーバーで、Sotcut プロジェクトの作成、編集、検証、プレビュー、およびレンダリングを行います.

概要

モデルコンテキストプロトコルによるローカルビデオ編集。 あなたのAIアシスタントを通じて保存されたショットカットプロジェクトを作成、編集、検証、プレビュー、およびレンダリングします。 結果は編集可能な .mlt のタイムラインを維持します。トランザクションの書き込みで、プロジェクトを作業として保護します。 ショットカットMCPで編集したネイティブのショットカットタイムラインから作られたショートH.264エクスポート。 [https://github.com/user-attachments/assets/c70f064f-17e7-403d-9bcf-689a9c616cdf] ローカルstdioサーバーをサポートするMCPクライアント、(推奨、バンドルされたMLT)が必要です。 ショットカットには、必要なメディアツール、コーデック、フィルタが含まれます。 追加のPythonパッケージは必要ありません。 インストールガイドには、Windows、macOS、Linuxのコマンドが含まれています。 サーバの実行には pip をインストールする必要はありません。 ソースのチェックアウトには、MCP を接続する前に、Python と Shotcut をスクリプト/shotcut mcp server.py --check でチェックする方法も表示されます。 shotcut statusとshotcut doctorを実行します。 ツールパス、バージョン、および実行時間チェックの失敗を報告します.

概要(AI 翻訳)

モデルコンテキストプロトコルによるローカルビデオ編集。

あなたのAIアシスタントを通じて保存されたショットカットプロジェクトを作成、編集、検証、プレビュー、およびレンダリングします。 結果は編集可能な[.mltタイムラインを維持し、プロジェクトを作業として保護するトランザクションの書き込みを行います。

デモ・クイックスタート・ドキュメンテーション・サイト

デモ

ショットカットMCPで編集したネイティブのショットカットタイムラインから作られたショートH.264エクスポート。

[https://github.com/user-attachments/assets/c70f064f-17e7-403d-9bcf-689a9c616cdf]

クイックスタート

Python 3.10+、Shotcut(推奨26.8.1*、バンドルされたMLT 7.41.0)、ローカル[[stdio]サーバーをサポートするMCPクライアントが必要です。 ショットカットには、必要なメディアツール、コーデック、フィルタが含まれます。 追加のPythonパッケージは必要ありません。

##1. クライアントを接続する

| クライアント | インストール | | お問い合わせ | | Claude Desktop / MCPB対応クライアント | MCPBインストールとアップデートガイドに従ってください | | コーデックス | リポジトリのクローン化とローカルサーバの登録 | | クロードコード | [[T3] を実行し、/plugin install shotcut-mcp@matrodrigs と [[T5] を実行します。 詳細・マニュアル設定 |

このページは 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.
GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者?mcpskill.org のガイドから始めましょう →