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.jsHTTP模式（远程访问）
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": "",
"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": "",
"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是字节跳动有限公司的商标。