快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

pip install -r requirements.txt

详细介绍

CapCut MCP服务器

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

🎬 特性

完整的视频编辑套件：创建草稿、添加视频、音频、文本、图像、效果等
专业工具：11个用于视频制作工作流程的专用工具
类型安全：使用TypeScript构建，具有可靠性和出色的IDE支持
柔性运输：支持stdio（本地）和HTTP（远程）连接
输入验证：全面的Zod模式，带有有用的错误消息
双输出格式：JSON用于机器，Markdown用于人类

📋 先决条件

在使用此MCP服务器之前，您需要 VectCutAPI 的 （CapCut API服务器）正在运行：

安装VectCutAPI:

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

启动API服务器:

   python capcut_server.py

服务器将于启动 http://localhost:9001 默认情况下。

🚀 安装

选项1：从npm安装（一旦发布）

npm install -g capcut-mcp-server

选项2：从源代码构建

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

# Install dependencies
npm install

# Build the project
npm run build

# Test the server
npm start

🔧 配置

适用于克劳德桌面

添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %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"
      }
    }
  }
}

对于其他MCP客户端

服务器支持两种传输模式：

标准模式（默认-本地集成）

node dist/index.js

HTTP模式（远程访问）

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

🛠️ 可用工具

1. `capcut_create_draft`

使用自定义尺寸和帧率创建新的视频编辑项目。

示例:

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

2. `capcut_add_video`

添加带有过渡、速度控制和音量调节的视频剪辑。

示例:

{
  "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`

添加背景音乐或具有淡入/淡出功能的音效。

示例:

{
  "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`

添加带有动画、阴影和背景的样式化文本覆盖。

示例:

{
  "draft_id": "abc123",
  "text": "Welcome!",
  "start": 0,
  "end": 3,
  "font_size": 72,
  "font_color": "#FFFFFF",
  "background_color": "#000000",
  "shadow_enabled": true,
  "animation": "fade_in"
}

5. `capcut_add_image`

添加具有定位、缩放和旋转功能的图像叠加。

示例:

{
  "draft_id": "abc123",
  "image_url": "https://example.com/logo.png",
  "start": 0,
  "end": 5,
  "position_x": 0.9,
  "position_y": 0.1,
  "scale": 0.3
}

6. `capcut_add_subtitle`

使用自定义样式从SRT格式导入字幕。

示例:

{
  "draft_id": "abc123",
  "srt_content": "1\n00:00:01,000 --> 00:00:03,000\nWelcome to my video",
  "font_size": 36,
  "font_color": "#FFFFFF",
  "background_enabled": true
}

7. `capcut_add_keyframe`

使用关键帧插值创建平滑的动画。

示例:

{
  "draft_id": "abc123",
  "track_name": "main",
  "property_types": ["scale_x", "scale_y"],
  "times": [0, 2, 4],
  "values": ["1.0", "1.5", "1.0"]
}

8. `capcut_add_effect`

应用模糊、亮度、饱和度等视觉效果。

示例:

{
  "draft_id": "abc123",
  "effect_name": "blur",
  "start": 0,
  "end": 2,
  "intensity": 0.7
}

9. `capcut_add_sticker`

添加装饰贴纸或表情符号。

示例:

{
  "draft_id": "abc123",
  "sticker_url": "https://example.com/emoji.png",
  "start": 1,
  "end": 5,
  "position_x": 0.9,
  "position_y": 0.1,
  "scale": 0.2
}

10. `capcut_save_draft`

保存草稿以导入CapCut应用程序。

示例:

{
  "draft_id": "abc123"
}

11. `capcut_get_duration`

获取媒体文件的持续时间和元数据。

示例:

{
  "url": "https://example.com/video.mp4"
}

📖 用法示例

完整的视频创建工作流程

// 1. Create a new draft
const draft = await capcut_create_draft({
  width: 1920,
  height: 1080,
  fps: 30
});

// 2. Add background video
await capcut_add_video({
  draft_id: draft.draft_id,
  video_url: "https://example.com/background.mp4",
  start: 0,
  end: 10,
  volume: 0.6
});

// 3. Add title text
await capcut_add_text({
  draft_id: draft.draft_id,
  text: "Amazing Video",
  start: 1,
  end: 4,
  font_size: 72,
  animation: "fade_in"
});

// 4. Add background music
await capcut_add_audio({
  draft_id: draft.draft_id,
  audio_url: "https://example.com/music.mp3",
  start: 0,
  end: 10,
  volume: 0.5
});

// 5. Add zoom animation
await capcut_add_keyframe({
  draft_id: draft.draft_id,
  track_name: "main",
  property_types: ["scale_x", "scale_y"],
  times: [0, 5, 10],
  values: ["1.0", "1.2", "1.0"]
});

// 6. Save the draft
const result = await capcut_save_draft({
  draft_id: draft.draft_id
});

console.log(`Draft saved to: ${result.draft_url}`);

🎯 用例

人工智能视频生成：让AI助手创建完整的视频项目
批量视频制作：从模板自动创建多个视频
社交媒体内容：自动生成TikTok、Reels和YouTube短片
教育内容：创建具有同步文本和音频的教程视频
营销自动化：大规模制作宣传视频

🔍 故障排除

服务器无响应

确保VectCutAPI服务器在端口9001上运行
检查 CAPCUT_API_URL 环境变量正确
验证与API服务器的网络连接

构建错误

# Clean and rebuild
rm -rf dist node_modules package-lock.json
npm install
npm run build

未找到媒体文件

确保所有媒体URL均可访问
使用文件的直接链接（避免重定向）
检查是否支持文件格式

🤝 贡献

欢迎投稿！请随时提交拉取请求。

📄 许可证

麻省理工学院许可证-请在您的项目中自由使用！

🙏 致谢

建在上面 VectCutAPI 的孙冠南著
使用模型上下文协议规格
由...驱动 Anthropic的MCP SDK

📞 支持

关于以下问题：

此MCP服务器：在此存储库中打开一个问题
VectCutAPI 的：参观https://github.com/sun-guannan/VectCutAPI
CapCut应用程序：联系CapCut支持

______________________________________________________________________

备注：这是CapCut Pro的非官方MCP服务器。它需要VectCutAPI后端才能运行。CapCut是字节跳动有限公司的商标。

目录标签

批量处理TypeScriptClaude视频编辑本地部署自动化工具AI视频生成社交媒体内容

支持客户端

Claude DesktopClaude

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

none

工具数量（toolCount，工具数）

11

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdionone部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/98b7156c4d1522c972abe0a8aa6627da

CapCut MCP Server是一个专业的视频编辑自动化服务，通过程序化方式利用CapCut Pro的强大编辑功能创建和编辑视频。

继续浏览同类 MCP

更多音视频 MCP（1,391）返回 MCP 目录

上一个 MCP

Capcut MCP Back

一个提供CapCut视频草稿编辑功能的REST API后端服务，支持创建和管理项目、添加多媒体轨道、应用特效和动画，并通过本地HTTP端点暴露功能。

下一个 MCP

Capcut MCP Server Extended

CapCut MCP Server是一个通过Claude Code自动化CapCut视频编辑的扩展服务器，支持参数化排版、动画预设和完整的说话头部制作工作流程。

Capcut MCP Server