Coze Video Concatenator MCP Plugin

这是一个用于Coze视频拼接工作流的MCP (Model Context Protocol) 插件，可以通过npx直接安装和使用。

功能特性

• 支持音频和视频URL输入进行拼接
• 使用Coze工作流API进行视频处理
• 完全兼容MCP协议
• 支持npx一键安装

安装

方法1: 通过npx直接使用（推荐）

npx coze-video-concatenator-mcp

方法2: 全局安装

npm install -g coze-video-concatenator-mcp

方法3: 本地开发

git clone <repository-url>
cd coze-video-concatenator-mcp
npm install
npm start

配置

环境变量

在使用前，需要设置以下环境变量：

export COZE_API_KEY="your_coze_api_key_here"

或者在Windows PowerShell中：

$env:COZE_API_KEY="your_coze_api_key_here"

MCP客户端配置

在你的MCP客户端配置文件中添加：

{
  "mcpServers": {
    "coze-video-concatenator": {
      "command": "npx",
      "args": ["coze-video-concatenator-mcp"],
      "env": {
        "COZE_API_KEY": "your_coze_api_key_here"
      }
    }
  }
}

使用方法

工具描述

插件提供以下工具：

• run_video_concatenation_workflow: 使用Coze工作流进行视频拼接

输入参数

{
  "audio_url": "https://example.com/audio.opus",
  "video_url": "https://example.com/video.mp4",
  "workflow_id": "7543467688297070602"
}

• audio_url (必需): 输入音频的URL地址
• video_url (必需): 输入视频的URL地址
• workflow_id (可选): Coze工作流ID，默认为 "7543467688297070602"

输出格式

插件返回Coze API的完整响应，包含：

• code: 状态码
• data: 包含输出视频URL的数据
• msg: 状态消息
• usage: 使用统计

示例

基本使用

# 设置API密钥
export COZE_API_KEY="cztei_qOCtUeKFiniUP2KTxk6JUXhsU8KCC701etWr7OT2gEn3GdX21kw0N92SUY1tXDceD"

# 启动MCP服务器
npx coze-video-concatenator-mcp

API调用示例

curl -X POST 'https://api.coze.cn/v1/workflow/run' \
-H "Authorization: Bearer cztei_qOCtUeKFiniUP2KTxk6JUXhsU8KCC701etWr7OT2gEn3GdX21kw0N92SUY1tXDceD" \
-H "Content-Type: application/json" \
-d '{
  "workflow_id": "7543467688297070602",
  "parameters": {
    "input": "audio: https://common-transcode-test-video.tos-cn-beijing.volces.com/test_data/audio/ff-16b-1c-44100hz.opus,video: https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/d12c041679e849b08eb0f71cf4dd8202"
  }
}'

依赖要求

• Node.js >= 18.0.0
• curl 命令行工具

故障排除

常见问题

1. API密钥错误: 确保正确设置了 COZE_API_KEY 环境变量
2. curl命令不存在: 确保系统安装了curl命令行工具
3. 权限问题: 确保有足够的权限执行npm和npx命令

调试模式

启动时添加调试信息：

DEBUG=* npx coze-video-concatenator-mcp

许可证

MIT License

贡献

欢迎提交Issue和Pull Request！

更新日志

v1.0.0

• 初始版本
• 支持音频和视频URL拼接
• 兼容MCP协议
• 支持npx安装