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：7543475034791936027

使用方法

启动MCP服务器

npm start

可用的MCP工具

1. 视频拼接工作流 (run_video_concatenation_workflow)

{
  "name": "run_video_concatenation_workflow",
  "arguments": {
    "video_urls": [
      "https://example.com/video1.mp4",
      "https://example.com/video2.mp4"
    ]
  }
}

参数说明:

• video_urls (必需): 输入视频的URL地址数组，多个视频将按顺序拼接
• workflow_id: Coze工作流ID，默认: 7543475034791936027

测试

使用Node.js脚本测试

运行提供的测试脚本：

npm test

使用MCP客户端测试

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

# 示例：运行视频拼接工作流
curl -X POST "http://localhost:3000/tools/run_video_concatenation_workflow" \
  -H "Content-Type: application/json" \
  -d '{
    "video_urls": [
      "https://example.com/video1.mp4",
      "https://example.com/video2.mp4"
    ]
  }'

配置选项

环境变量

• COZE_API_KEY: Coze API密钥 (必需)

默认参数

• 工作流ID: 7543475034791936027

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服务器
5. 视频格式: 确保所有输入视频格式兼容

故障排除

常见问题

1. API密钥错误

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

2. 网络连接问题

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

3. 视频URL问题

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

4. 拼接失败

   • 检查视频格式是否一致
   • 确认视频分辨率是否兼容

日志查看

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

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

许可证

MIT License

贡献

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

更新日志

v1.0.0

• 添加Coze视频拼接工作流功能
• 集成MCP协议支持
• 支持多个视频URL输入
• 完善错误处理和配置管理