OpusClip

@mindstone/mcp-server-opus-video-clip

适用于 Model Context Protocol 宿主的 OpusClip MCP 服务。通过 OpusClip API，将长视频转换为短片段，并管理项目、合集、审查任务和定时社交媒体帖子。

要求

• Node.js 20+
• npm
• OpusClip API 密钥（https://app.opus.pro/settings/integration-tokens）

一键安装

点击按钮后，宿主会提示你填写：OPUS_API_KEY、OPUS_API_TIMEOUT_MS、OPUS_UPLOAD_TIMEOUT_MS、OPUS_BRIDGE_TIMEOUT_MS。

{
  "mcpServers": {
    "OpusClip": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-opus-video-clip"
      ],
      "env": {
        "OPUS_API_KEY": "",
        "OPUS_API_TIMEOUT_MS": "120000",
        "OPUS_UPLOAD_TIMEOUT_MS": "600000",
        "OPUS_BRIDGE_TIMEOUT_MS": "30000"
      }
    }
  }
}

快速开始

安装并构建

cd <path-to-repo>/connectors/opus-video-clip
npm install
npm run build

npx（发布后使用）

npx -y @mindstone/mcp-server-opus-video-clip

本地

node dist/index.js

配置

环境变量

• OPUS_API_KEY — OpusClip API 密钥
• MCP_HOST_BRIDGE_STATE — 可选的宿主桥接状态文件路径，用于管理凭据
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE 的向后兼容别名
• OPUS_API_TIMEOUT_MS — 一般 Opus API 调用的出站 HTTP 超时时间（默认 120000 ms，最长 30 min）
• OPUS_UPLOAD_TIMEOUT_MS — GCS 可续传上传的分块 HTTP 超时时间（默认 600000 ms，最长 30 min）
• OPUS_BRIDGE_TIMEOUT_MS — 可选宿主应用桥接的 HTTP 超时时间（默认 30000 ms，最长 30 min）
• MCP_WORKSPACE_PATH — 用于访问本地文件的工作区目录（见下文）

本地文件沙箱

opus_upload_video（读取）和 opus_download_clip（写入）受工作区沙箱限制：若设置了 MCP_WORKSPACE_PATH，则使用该路径；否则使用系统临时目录。拒绝访问沙箱外的路径，包括 .. 路径遍历以及会逃逸出沙箱的符号链接。上传前，请将源视频放入工作区（或临时）目录；下载目标也应位于其中。

宿主配置示例

Claude Desktop / Cursor

{
  "mcpServers": {
    "OpusClip": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-opus-video-clip"],
      "env": {
        "OPUS_API_KEY": "your-api-key"
      }
    }
  }
}

本地开发（无需发布到 npm）

{
  "mcpServers": {
    "OpusClip": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/opus-video-clip/dist/index.js"],
      "env": {
        "OPUS_API_KEY": "your-api-key"
      }
    }
  }
}

工具（22）

配置

• configure_opus_api_key — 配置 OpusClip API 密钥

品牌模板

• opus_get_brand_templates — 列出品牌模板

项目生命周期

• opus_create_project — 提交长视频 URL 以创建剪辑项目（标记为破坏性操作）
• opus_get_project — 获取项目状态、元数据和剪辑
• opus_get_clips — 获取项目生成的剪辑（提供分页元数据：total/next/limit）
• opus_share_project — 更新项目的共享可见性（标记为破坏性操作）

上传

• opus_upload_video — 上传本地视频文件并创建剪辑项目（编排 4 步 GCS 可续传上传；读取操作仅限工作区沙盒内；标记为破坏性操作）

下载

• opus_download_clip — 将导出的剪辑 MP4 下载到工作区沙盒内的本地文件。仅接受 OpusClip CDN / Google Cloud Storage 主机；主机名会进行 DNS 解析，且所有解析出的地址都必须是公开地址

审查任务

• opus_create_censor_job — 为剪辑创建审查任务（标记为破坏性操作）
• opus_get_censor_job_status — 轮询审查任务的状态

集合

• opus_create_collection — 创建剪辑集合（标记为破坏性操作）
• opus_get_collections — 列出你的集合
• opus_export_collection — 导出集合中的所有剪辑
• opus_delete_collection — 删除集合（保留剪辑本身）

集合内容

• opus_add_clip_to_collection — 将剪辑添加到现有集合
• opus_remove_clip_from_collection — 从集合中移除剪辑（使用 Opus 的 POST 实现删除的惯例）

社交平台发布

• opus_get_social_accounts — 列出已连接的社交账号
• opus_create_social_copy_job — 为剪辑生成特定平台的社交文案
• opus_get_social_copy_job — 获取社交文案任务的结果
• opus_publish_post — 立即将剪辑发布到已连接的社交账号（标记为破坏性操作）
• opus_schedule_post — 安排在未来发布剪辑（标记为破坏性操作）
• opus_cancel_scheduled_post — 取消已安排的社交帖子

Opus API 返回的外部文本（项目／剪辑标题、模板和集合名称、社交账号显示名称、生成的社交文案、上游错误字符串和错误正文、任务状态及续传令牌）均封装在 <untrusted-content> 包络中，以便模型将其视为数据，而非指令。

许可证

FSL-1.1-MIT — Functional Source License，Version 1.1，未来将采用 MIT 许可证。该软件将于 2030-05-19 转为 MIT 许可证。