一台专业的模型上下文协议（MCP）服务器，用于CapCut Pro视频编辑自动化。该服务器使AI助手和应用程序能够通过CapCut强大的编辑功能程序化创建和编辑视频。

🎬 特色

• 完整视频编辑套件：创建草稿，添加视频、音频、文本、图片、特效等
• 专业工具：11款专门用于视频制作工作流程的工具
• 类型安全：采用TypeScript构建，保证可靠性和卓越的IDE支持。
• 灵活传输：支持本地（stdio）和HTTP（远程）连接
• 输入验证：包含有用的错误信息的综合Zod模式
• 双输出格式：机器用JSON，人类用Markdown

📋 先修条件

在使用这个MCP服务器之前，你需要先运行VectCutAPI（CapCut API服务器）：

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