Профессиональный сервер Model Context Protocol (MCP) для автоматизации редактирования видео. Этот сервер позволяет ИИ-ассистентам и приложениям создавать и редактировать видео программно с помощью мощных возможностей редактирования CapCut.

Feature Особенности

Complete Video Editing Suite: создавать черновики, добавлять видео, аудио, текст, изображения, эффекты и многое другое Профессиональные инструменты: 11 специализированных инструментов для рабочих процессов видеопроизводства

• ** Безопасный тип**: Создан с помощью TypeScript для надежности и отличной поддержки IDE ** Гибкий транспорт**: поддерживает как локальные, так и удаленные соединения ** Вводная валидация**: всеобъемлющий Схемы Зода с полезными сообщениями об ошибках Форматы двойного выхода: JSON для машин, Markdown для людей

Предпосылки

Перед использованием этого MCP-сервера вам необходимо запустить VectCutAPI (сервер API CapCut):

1Установить VectCutAPI:

2. ** Запустите API-сервер**:

Сервер будет запущен по умолчанию http://localhost:9001.

###Установка

Вариант 1: Установить из npm (однажды опубликовано)

Вариант 2: Построение из источника

Конфигурация

###Клод Десктоп

Добавьте файл конфигурации Claude Desktop:

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