Coze视频剪辑工作流 MCP 插件

这是一个基于Model Context Protocol (MCP)的Coze视频剪辑工作流插件，可以让AI助手直接调用Coze的视频剪辑能力。

功能特性

• 🎬 视频剪辑: 根据指定的开始和结束时间剪辑视频
• 🔧 MCP集成: 完全兼容MCP协议，可与支持MCP的AI助手集成
• 📹 视频输入: 支持URL视频作为输入源
• ⏱️ 时间控制: 精确控制剪辑的开始和结束时间
• 🚀 工作流集成: 使用Coze预定义的工作流进行视频处理

安装和配置

1. 安装依赖

npm install

2. 设置API密钥

设置环境变量 COZE_API_KEY：

Windows (PowerShell):

$env:COZE_API_KEY="your_api_key_here"

Windows (CMD):

set COZE_API_KEY=your_api_key_here

Linux/Mac:

export COZE_API_KEY="your_api_key_here"

3. 配置工作流ID

默认使用工作流ID：7543150232101322793

使用方法

启动MCP服务器

npm start

可用的MCP工具

1. 视频剪辑工作流 (run_video_edit_workflow)

{
  "name": "run_video_edit_workflow",
  "arguments": {
    "video_url": "https://example.com/video.mp4",
    "start_time": 1,
    "end_time": 8
  }
}

参数说明:

• video_url (必需): 输入视频的URL地址
• start_time: 剪辑开始时间（秒），默认: 0
• end_time (必需): 剪辑结束时间（秒）
• workflow_id: Coze工作流ID，默认: 7543150232101322793

测试

使用Node.js脚本测试

运行提供的测试脚本：

npm test

使用MCP客户端测试

如果你有支持MCP的客户端，可以直接调用工具：

# 示例：运行视频剪辑工作流
curl -X POST "http://localhost:3000/tools/run_video_edit_workflow" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/video.mp4",
    "start_time": 1,
    "end_time": 8
  }'

配置选项

环境变量

• COZE_API_KEY: Coze API密钥 (必需)

默认参数

• 工作流ID: 7543150232101322793
• 开始时间: 0

API响应格式

成功响应示例：

{
    "code": 0,
    "data": "{\"output\":\"https://coze-dianbo.tos-cn-beijing.volces.com/******.mp4\"}",
    "debug_url": "https://www.coze.cn/work_flow?execute_id=******",
    "msg": "Success",
    "usage": {
        "input_count": 0,
        "output_count": 0,
        "token_count": 0
    }
}

错误处理

插件包含完善的错误处理：

• API密钥验证
• 网络请求超时
• 参数验证
• 错误信息返回

注意事项

1. API密钥安全: 请妥善保管你的API密钥，不要提交到代码仓库
2. 请求限制: 注意Coze API的请求频率限制
3. 视频URL: 确保输入视频URL可以正常访问
4. 网络环境: 确保能够访问Coze API服务器

故障排除

常见问题

1. API密钥错误

   • 检查环境变量是否正确设置
   • 确认API密钥是否有效

2. 网络连接问题

   • 检查网络连接
   • 确认防火墙设置

3. 视频URL问题

   • 检查输入视频URL是否可访问
   • 确认视频格式是否支持

日志查看

MCP服务器会在控制台输出错误信息，包括：

• API请求状态
• 错误详情
• 调试信息

许可证

MIT License

贡献

欢迎提交Issue和Pull Request来改进这个插件！

更新日志

v1.0.0

• 添加Coze视频剪辑工作流功能
• 集成MCP协议支持
• 支持视频URL输入和时间控制
• 完善错误处理和配置管理