Claude read と CapCut デスクトップ ドラフト プロジェクトを編集できる MCP サーバー — Add/move/trim/split クリップ、テキスト、オーディオ、画像; セット 変換; 検証; 保存。 既存のドラフト(有効なCapCut JSONを生成する唯一の信頼できる方法)から、実質のセグメント/マテリアルテンプレートをクローニングし、バックアップと検証パスで原子的に保存します。

**無料&オープンソース(MIT) ジェームス・アルドリン・ボカルズがClaudeをドライブしたいエディタ向けに構築しました。 ツイート CapCut または ByteDance と提携していません。 CapCutのドラフトフォーマットは、独自で非ドキュメント化されています。このツールは、防御的に読み書きします(クローンからテンプレート、バックアップ、検証)が、CapCutの更新はスキーマをシフトできます。 バックアップを作成します。

要件

• ノード 18+ -PATHのffmpeg/ffprobe** (媒体の持続期間/決断を読むために使用される) -CapCutデスクトップ(想定されるWindowsレイアウト; macOSパスも自動検出)

設定 (env, オプション)

• [[CAPCUT_DRAFTS_DIR] — あなたのCapCut Draftsフォルダ。 標準的な[[%LOCALAPPDATA%\CapCut\...(Windows)/[~/Movies/CapCut/...場所を自動検出します。あなたの草案が他の場所で住んでいる場合は、これを設定します(異なるドライブなど).

capcut-mcp

An MCP server that lets Claude read and edit CapCut desktop draft projects — add/move/trim/split clips, text, audio, images; set transforms; validate; save. It works by cloning real segment/material templates out of an existing draft (the only reliable way to produce valid CapCut JSON), and it saves atomically with a backup and a validation pass.

Free & open source (MIT). Built by James Aldrin Boncales for editors who want Claude to drive CapCut for them.

Not affiliated with CapCut or ByteDance. CapCut’s draft format is proprietary and undocumented; this tool reads/writes it defensively (clone-from-template, backups, validation), but a CapCut update can shift the schema. Keep the backups it makes.

Requirements

• Node 18+
• ffmpeg/ffprobe on PATH (used to read media duration/resolution)
• CapCut desktop (Windows layout assumed; macOS path is auto-detected too)

Configure (env, optional)

• CAPCUT_DRAFTS_DIR — your CapCut Drafts folder. Auto-detects the standard %LOCALAPPDATA%\CapCut\... (Windows) / ~/Movies/CapCut/... (macOS) locations; set this if your drafts live elsewhere (e.g. a different drive).
• CAPCUT_TEMPLATE_DRAFT — name of a draft that contains video and text layers, used to harvest templates when the draft you’re editing lacks one. Default 0723 is the author’s own draft and won’t exist on your machine — set this to one of your drafts that has a text layer, or the capcut_add_text tool won’t work. (Everything else works without it.)

Install

git clone https://github.com/JmsLdrn/capcut-mcp
cd capcut-mcp
npm install

Then register it in Claude Code — use the absolute path to src/server.js on your machine:

claude mcp add capcut --scope user -- node "/ABSOLUTE/PATH/TO/capcut-mcp/src/server.js"

…or add a project-scoped .mcp.json at your repo root (copy mcp.json.example and edit the paths):

{
  "mcpServers": {
    "capcut": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/capcut-mcp/src/server.js"],
      "env": { "CAPCUT_DRAFTS_DIR": "", "CAPCUT_TEMPLATE_DRAFT": "" }
    }
  }
}

Leave the env values blank to auto-detect, or fill them in (see Configure above). Restart Claude Code; the tools then appear as mcp__capcut__*.

Workflow (important)

1. Close CapCut on the draft you want to edit. CapCut autosaves on a timer; writing while it’s open gets clobbered. capcut_save refuses if CapCut is running or the draft’s .locked file is present (override with force: true only if you know it’s safe).
2. Edits are a session: capcut_add_* / capcut_move_* etc. accumulate in memory. Nothing hits disk until capcut_save.
3. capcut_save writes draft_content.json (+ meta) atomically after making a .mcpbak backup, and runs capcut_validate.
4. Reopen the draft in CapCut.