Capcut MCP Server Extended

CapCut MCP服务器——扩展

用于自动化的扩展MCP（模型上下文协议）服务器 通过Claude Code进行CapCut视频编辑。支持参数化 排版、动画预设和全对话头制作工作流程。

基于

这个项目是 capcut mcp服务器 通过 @atx家伙，在麻省理工学院获得许可。

所有原始工具均已保留并扩展：

• 参数化排版系统（字体、大小、位置、颜色）
• 动画预设库
• 通话头制作预设
• 卷轴/短裤工作流程预设
• 字幕样式系统

工具

需求

• Node.js 18+
• 克劳德代码
• CapCut（Windows或Mac）

安装

git clone https://github.com/TU_USUARIO/capcut-mcp-server-pro
cd capcut-mcp-server-pro
npm install
npm run build
claude mcp add capcut -- node /ruta/dist/index.js

用法

claude
> Crea un proyecto talking head con el video en C:/grabacion.mp4, 
  subtítulos en blanco, fuente Montserrat 72px, y guárdalo en CapCut

许可证

麻省理工学院——见 许可证

CapCut MCP服务器

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

🎬 特性

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

📋 先决条件

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

1. 安装VectCutAPI:

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

1. 启动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是字节跳动有限公司的商标。