CapCut Pro 비디오 편집 자동화를 위한 Professional Model Context Protocol (MCP) 서버. 이 서버는 CapCut의 강력한 편집 기능을 통해 비디오 프로그래밍을 만들고 편집하기 위해 AI 조수 및 응용 프로그램을 가능하게 합니다.

₢ 킹

-Complete Video Editing Suite: 초안 만들기, 비디오 추가, 오디오, 텍스트, 이미지, 효과, 그리고 더 -Professional Tools: 비디오 제작 작업 흐름을 위한 11개의 전문 툴

• Type-Safe: 신뢰성과 우수한 IDE 지원을위한 TypeScript 내장
• Flexible Transport: stdio(local) 및 HTTP(remote) 연결을 모두 지원합니다.
• ** 입력 유효성**: 제품정보 Zod schemas 와 도움 오류 메시지
• Dual Output Formats: 기계용 JSON, 인간용 Markdown

Pre Pre

이 MCP 서버를 사용하기 전에 VectCutAPI (CapCut API server) 실행이 필요합니다.

1. Install VectCutAPI:

2. **API 서버 시작 **:

서버는 기본적으로 http://localhost:9001에서 시작합니다.

♨ 설치

선택권 1: npm에서 설치하십시오 (논서 발행되는)

선택권 2: 근원에서 구조

₢ 킹

Claude 데스크탑

Claude Desktop config 파일에 추가:

CapCut MCP Server

A professional Model Context Protocol (MCP) server for CapCut Pro video editing automation. This server enables AI assistants and applications to create and edit videos programmatically through CapCut’s powerful editing capabilities.

🎬 Features

• Complete Video Editing Suite: Create drafts, add videos, audio, text, images, effects, and more
• Professional Tools: 11 specialized tools for video production workflows
• Type-Safe: Built with TypeScript for reliability and excellent IDE support
• Flexible Transport: Supports both stdio (local) and HTTP (remote) connections
• Input Validation: Comprehensive Zod schemas with helpful error messages
• Dual Output Formats: JSON for machines, Markdown for humans

📋 Prerequisites

Before using this MCP server, you need to have the VectCutAPI (CapCut API server) running:

1. Install VectCutAPI:

   git clone https://github.com/sun-guannan/VectCutAPI.git
   cd VectCutAPI
   pip install -r requirements.txt
   

2. Start the API Server:

   python capcut_server.py
   

   The server will start on http://localhost:9001 by default.

🚀 Installation

Option 1: Install from npm (once published)

npm install -g capcut-mcp-server

Option 2: Build from Source

# Clone this repository
git clone 
cd capcut-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Test the server
npm start

🔧 Configuration

For Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "capcut": {
      "command": "node",
      "args": ["/absolute/path/to/capcut-mcp-server/dist/index.js"],
      "env": {
        "CAPCUT_API_URL": "http://localhost:9001"
      }
    }
  }
}

For Other MCP Clients

The server supports two transport modes:

Stdio Mode (Default - Local Integration)

node dist/index.js

HTTP Mode (Remote Access)

TRANSPORT=http PORT=3000 node dist/index.js

🛠️ Available Tools

1. capcut_create_draft

Create a new video editing project with custom dimensions and frame rate.

Example:

{
  "width": 1920,
  "height": 1080,
  "fps": 30
}

2. capcut_add_video

Add video clips with transitions, speed control, and volume adjustments.

Example:

{
  "draft_id": "abc123",
  "video_url": "https://example.com/video.mp4",
  "start": 0,
  "end": 10,
  "volume": 0.8,
  "transition": "fade_in",
  "speed": 1.0
}

3. capcut_add_audio

Add background music or sound effects with fade in/out.

Example:

{
  "draft_id": "abc123",
  "audio_url": "https://example.com/music.mp3",
  "start": 0,
  "end": 30,
  "volume": 0.5,
  "fade_in": 2,
  "fade_out": 2
}

4. capcut_add_text