Capcut MCP API

CapCutAPI

开源CapCut API工具。

中文说明

项目特点

该项目是一个基于Python的CapCut处理工具，提供以下核心功能：

核心功能

• 草稿文件管理：创建、读取、修改和保存CapCut草稿文件
• 材料加工：支持添加和编辑各种材料，如视频、音频、图像、文本、贴纸等。
• 效果应用：支持添加多种效果，如过渡、滤镜、蒙版、动画等。
• API服务：提供HTTP API接口以支持远程调用和自动化处理
• 人工智能集成：集成多种人工智能服务，支持字幕、文本和图像的智能生成

API主要接口

• /create_draft：创建草稿
• /add_video：在草稿中添加视频材料
• /add_audio：在草稿中添加音频材料
• /add_image：将图像素材添加到草稿中
• /add_text：在草稿中添加文本材料
• /add_subtitle：在草稿中添加字幕
• /add_effect：为材质添加效果
• /add_sticker：在草稿中添加贴纸
• /save_draft：保存草稿文件

配置说明

配置文件

该项目支持通过配置文件进行自定义设置。要使用配置文件，请执行以下操作：

1. 复制 config.json.example 到 config.json
2. 根据需要修改配置项

cp config.json.example config.json

环境配置

FFmpeg

这个项目依赖于ffmpeg。您需要确保ffmpeg已安装在您的系统上并添加到系统的环境变量中。

Python环境

这个项目需要Python 3.8.20版本。请确保您的系统上安装了正确版本的Python。

再进行

为项目安装所需的依赖包：

pip install -r requirements.txt

运行服务器

完成配置和环境设置后，执行以下命令启动服务器：

python main.py

服务器启动后，您可以通过API接口访问相关函数。

使用示例

添加视频

import requests

response = requests.post("http://localhost:9000/add_video", json={
    "video_url": "http://example.com/video.mp4",
    "start": 0,
    "end": 10,
    "width": 1080,
    "height": 1920
})

print(response.json())

添加文本

import requests

response = requests.post("http://localhost:9000/add_text", json={
    "text": "Hello, World!",
    "start": 0,
    "end": 3,
    "font": "Source Han Sans",
    "font_color": "#FF0000",
    "font_size": 30.0
})

print(response.json())

保存草稿

import requests

response = requests.post("http://localhost:9000/save_draft", json={
    "draft_id": "123456",
    "draft_folder": "your capcut draft folder"
})

print(response.json())

将草稿复制到CapCut草稿路径

召唤 save_draft 将生成一个以开头的文件夹 dfd_ 在服务器的当前目录中。将此文件夹复制到CapCut草稿目录，您将能够看到生成的草稿。

配置MCP

在游标中配置MCP。在游标设置中，添加一个具有以下地址的MCP服务器 http://localhost:9000/mcp，然后您可以在游标中使用MCP。

在Claude配置中，添加以下内容：

{
    "mcpServers": {
        "capcut-mcp": {
            "type": "http",
            "url": "http://localhost:9000/mcp"
        }
    }
}

更多示例

请参阅 example.py 项目中的文件，其中包含更多使用示例，如添加音频和效果。

项目特点

• 与跨平台支持：支持CapCut中国版和CapCut国际版
• 自动处理：支持批处理和自动化工作流
• 丰富的API：提供全面的API接口，以便轻松集成到其他系统中
• 灵活配置：通过配置文件实现灵活的功能定制
• AI增强：整合多种人工智能服务，提高视频制作效率