OpusClip

io.github.mindstone由 GitHub 账号 mindstone 发布v0.3.0更新于 Nov 17, 2026

OpusClip MCP server — clip long-form videos, manage projects, collections, censor jobs, posts

已验证STDIO仅桌面沟通与协作媒体与设计

概览

AI 生成的概览

OpusClip MCP 服务器,让助手把长视频剪成短视频片段、管理项目与合集,并把片段发布到社交账号。

可以做什么
  • 通过视频链接创建剪辑项目或上传本地视频,查询项目进度并列出生成的片段
  • 列出品牌模板,并把导出的片段 MP4 下载到工作区目录
  • 创建、列出、导出和删除片段合集,并在合集中添加或移除片段
  • 创建消音任务,对片段中的脏话静音或加哔声,并查询任务状态
  • 列出已连接的社交账号,生成平台专属文案,并发布、定时发布或取消发布
  • 修改项目的分享可见范围
适用场景
适合希望让助手把长视频二次加工成短视频、用合集整理片段,或直接在对话中把成品片段推送到已连接社交账号的场景。
运行要求
通过 npx 在本地运行,需要 Node.js 20+ 和 npm。需要 OpusClip API 密钥,通过 OPUS_API_KEY 提供(或在宿主的连接器设置中配置)。可选变量用于设置超时和用于上传下载的 MCP_WORKSPACE_PATH 目录;需要访问 OpusClip API 与 Google Cloud Storage 的网络。
安装前请注意
API 密钥属于凭据,服务器要求在宿主设置中配置,而不是在对话中粘贴。多个工具被标记为破坏性操作:创建项目、上传、公开分享项目、消音任务、创建与删除合集,以及发布或定时发布帖子。发布到 X 每条帖子消耗 1 个额度,定时帖子过了发布时间便无法取消。上传的视频和片段数据会发送给 OpusClip 与 Google Cloud Storage。

安装

在 SourceWeft 中

  1. 打开 控制台中的 OpusClip,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

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

[License: FSL-1.1-MIT]

OpusClip MCP server for Model Context Protocol hosts. Turn long-form videos into short clips, manage projects, collections, censor jobs, and scheduled social posts through the OpusClip API.

Requirements

One-click install

[Add to Cursor] [Add to VS Code] [Add to VS Code Insiders]

After clicking the button, your host will prompt you to fill: OPUS_API_KEY, OPUS_API_TIMEOUT_MS, OPUS_UPLOAD_TIMEOUT_MS, OPUS_BRIDGE_TIMEOUT_MS.

Manual config for Claude Desktop / Claude Code / Goose / Continue.dev (OpusClip)
json
{  "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"      }    }  }}

Quick Start

Install & build

bash
cd <path-to-repo>/connectors/opus-video-clipnpm installnpm run build

npx (once published)

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

Local

bash
node dist/index.js

Configuration

Environment variables

  • OPUS_API_KEY — OpusClip API key
  • MCP_HOST_BRIDGE_STATE — optional path to a host bridge state file used for credential management
  • MINDSTONE_REBEL_BRIDGE_STATE — backwards-compatible alias for MCP_HOST_BRIDGE_STATE
  • OPUS_API_TIMEOUT_MS — outbound HTTP timeout for general Opus API calls (default 120000 ms, max 30 min)
  • OPUS_UPLOAD_TIMEOUT_MS — per-chunk HTTP timeout for GCS resumable upload (default 600000 ms, max 30 min)
  • OPUS_BRIDGE_TIMEOUT_MS — HTTP timeout for the optional host-app bridge (default 30000 ms, max 30 min)
  • MCP_WORKSPACE_PATH — workspace directory for local-file access (see below)

Local-file sandbox and input permissions

opus_download_clip writes are confined to a workspace sandbox: MCP_WORKSPACE_PATH when set, otherwise the system temp directory. Paths outside the sandbox — including .. traversal and symlinks that escape it — are refused. For standalone clients, including clients that do not negotiate files/readModes version 1, opus_upload_video reads follow these same restrictions: place source videos inside the workspace (or temp) directory before uploading. With negotiated version 1, the host selects a mode for each call: in central mode, input reads use only the host-authorized canonical path described under Host-authorized local inputs; in standalone mode, the standalone restrictions apply. In every mode, pick download targets inside the workspace (or temp) directory.

Host configuration examples

Claude Desktop / Cursor

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

Local development (no npm publish needed)

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

Tools (22)

Configuration

  • configure_opus_api_key — Configure the OpusClip API key

Brand templates

  • opus_get_brand_templates — List brand templates

Project lifecycle

  • opus_create_project — Submit a long-form video URL for clipping (marked destructive)
  • opus_get_project — Retrieve a project's status, metadata, and clips
  • opus_get_clips — Retrieve clips generated for a project (surfaces pagination metadata: total/next/limit)
  • opus_share_project — Update a project's sharing visibility (marked destructive)

Upload

  • opus_upload_video — Upload a local video file and create a clip project (orchestrates the 4-step GCS resumable upload; standalone-mode reads confined to the workspace sandbox, central-mode reads use only the host-authorized canonical path; marked destructive)

Downloads

  • opus_download_clip — Download an exported clip MP4 to a local file inside the workspace sandbox. Only OpusClip CDN / Google Cloud Storage hosts are accepted; hostnames are DNS-resolved and every resolved address must be public

Censor jobs

  • opus_create_censor_job — Create a censor job for a clip (marked destructive)
  • opus_get_censor_job_status — Poll the status of a censor job

Collections

  • opus_create_collection — Create a clip collection (marked destructive)
  • opus_get_collections — List your collections
  • opus_export_collection — Export all clips from a collection
  • opus_delete_collection — Delete a collection (clips themselves are preserved)

Collection contents

  • opus_add_clip_to_collection — Add a clip to an existing collection
  • opus_remove_clip_from_collection — Remove a clip from a collection (uses Opus's POST-to-delete idiom)

Social posting

  • opus_get_social_accounts — List connected social accounts
  • opus_create_social_copy_job — Generate platform-specific social copy for a clip
  • opus_get_social_copy_job — Retrieve the result of a social-copy job
  • opus_publish_post — Publish a clip to a connected social account immediately (marked destructive)
  • opus_schedule_post — Schedule a clip for future publishing (marked destructive)
  • opus_cancel_scheduled_post — Cancel a scheduled social post

External text returned by the Opus API (project/clip titles, template and collection names, social account display names, generated social copy, upstream error strings and error bodies, job statuses, and continuation tokens) is wrapped in <untrusted-content> envelopes so the model treats it as data, not instructions.

Licence

FSL-1.1-MIT — Functional Source License, Version 1.1, with MIT future licence. The software converts to MIT licence on 2030-05-19.

Host-authorized local inputs

files/readModes version 1 is an experimental extension used by these connectors, not part of the MCP standard. A compatible host (the app running the connector) decides which input files a tool call may read. The connector opens only the host-approved physical path, after resolving symlinks. The host supplies this permission information with each call; it is not a tool argument you need to set. Missing or invalid permission information, or a file absent from the approved list, stops the read.

Clients that do not negotiate this extension keep the connector's existing standalone file restrictions. This extension changes input-read permissions; existing output destinations, upload formats, size limits and file checks apply.

来源:connectors/opus-video-clip/README.md,提交 d908148

工具

22

configure_opus_api_key

Host-managed setup only. The user adds the OpusClip API key in Settings → Connectors in the app. Do not ask for or accept the key in chat. HOW USER GETS THEIR KEY: go to https://app.opus.pro/settings/integration-tokens and create a new token. After configuring, all other opus_* tools will work immediately.

输入参数api_key必填

opus_get_brand_templates

List the OpusClip brand templates available to your organisation. Brand templates control captions, fonts, colours, intro/outro cards, and other styling. Use a brand_template_id from this response with opus_create_project or opus_upload_video. NOTE: The Opus API requires the `q` parameter to equal "mine" — calling the endpoint without it returns an empty body. The schema below makes the only legal value compile-time enforced.

输入参数q

opus_create_project

Create a new OpusClip clipping project from a publicly importable long-form video URL. After this returns a projectId, poll opus_get_project to track stage progression (PENDING → QUEUED → IMPORT → CURATE → REFINE → RENDER → UPLOAD → COMPLETE). When complete, call opus_get_clips to retrieve the generated clips. For local files, use opus_upload_video instead — it handles upload-link generation, GCS resumable upload, and project creation in a single tool call.

输入参数videoUrl必填importPrefrenderPrefcurationPrefbrandTemplateIdconclusionActionsuploadedVideoAttr

opus_get_project

Retrieve the current status and metadata of an OpusClip project. Check the `stage` field — when it reaches "COMPLETE" the clips are ready (use opus_get_clips). If `stage` is "STALLED" or `error` is set, the project has failed.

输入参数projectId必填

opus_get_clips

List the exportable clips for a given project or collection. Each clip has a full-clip id of the form `{projectId}.{curationId}`, plus preview/export URLs (`uriForPreview`, `uriForExport`) on Google Cloud Storage. Choose `q: "findByProjectId"` and pass `projectId`, OR `q: "findByCollectionId"` and pass `collectionId`. Pagination via `pageNum` (starts at 1) and `pageSize`; the response echoes pagination inputs and surfaces upstream `total`/`next`/`limit` continuation metadata when available, so a truncated page is distinguishable from a complete list.

无需输入参数。

opus_share_project

Update the sharing visibility of an OpusClip project. `DEFAULT`: team members can open / edit / export. `PUBLIC`: anyone with the link can open / edit / export.

输入参数projectId必填visibility必填

opus_upload_video

Upload a local video file to OpusClip and create a clipping project in a single step. Orchestrates the 4-step Opus / Google Cloud Storage resumable upload: (1) request an upload link, (2) start a GCS resumable session, (3) PUT the video bytes (with automatic offset-query recovery on ambiguous failures), (4) create the project. Pass `file_path` as an absolute filesystem path. Optional `brandTemplateId`, `curationPref`, `renderPref`, `importPref`, `uploadedVideoAttr`, and `conclusionActions` are forwarded to `opus_create_project`. This tool is NOT idempotent: every invocation uploads the file and creates a NEW, potentially billable project — do not call it twice for the same source video. Per-chunk upload timeout is OPUS_UPLOAD_TIMEOUT_MS (default 600s).

输入参数file_path必填importPrefrenderPrefcurationPrefbrandTemplateIdconclusionActionsuploadedVideoAttr

opus_create_censor_job

Create a censor job that processes a specific clip and bleeps / mutes profanity. Returns a jobId. Poll opus_get_censor_job_status until status is "CONCLUDED" (success) or "FAILED". Set `options.beepSound: true` to substitute a beep for censored words; default is to mute them.

输入参数clipId必填optionsprojectId必填

opus_get_censor_job_status

Poll the status of an OpusClip censor job. Status values: "QUEUED" / "PROCESSING" (still running, poll again), "CONCLUDED" (success), "FAILED" (check error), "UNKNOWN" (Opus could not determine the state — surfaced as UPSTREAM_STATUS_UNKNOWN). The response includes `next_poll_after_seconds` honouring Retry-After when present.

输入参数jobId必填attempt

opus_create_collection

Create a new clip collection to organise your clips. Returns the new collectionId. Use opus_add_clip_to_collection to populate it.

输入参数collectionName必填

opus_get_collections

List your OpusClip collections. Use `q: "mine"` to list all collections on your account, or `q: "findByContentId"` (with `contentId` set to a full clip id like "{projectId}.{curationId}") to find which collections contain a specific clip.

无需输入参数。

opus_export_collection

Export all clips from a collection. Returns a `contentList` of `{ contentId, uriForExport }` pairs — the uriForExport URLs are Google Cloud Storage download links for the clip MP4s.

输入参数collectionId必填

opus_delete_collection

Delete a clip collection. IMPORTANT: only the collection container is deleted — the clips themselves are preserved and still accessible via opus_get_clips with `q: "findByProjectId"`.

输入参数collectionId必填

opus_add_clip_to_collection

Add a clip to an existing collection. `contentId` is the full clip ID in the form `{projectId}.{curationId}` (e.g. "Q20107035eDq.CU0b92e6") — get it from opus_get_clips.

输入参数contentId必填collectionId必填

opus_remove_clip_from_collection

Remove a clip from a collection. IMPORTANT: Opus exposes this operation as a POST to /api/collection-contents/delete-collection-contents (NOT a DELETE). The clip itself is not deleted — only the collection membership is removed.

输入参数contentId必填collectionId必填

opus_download_clip

Download an exported clip MP4 to a local file. Pass a `uriForExport` URL from opus_get_clips or opus_export_collection. Only OpusClip CDN / Google Cloud Storage hosts are accepted; hostnames are DNS-resolved and every resolved address must be public. output_path MUST live inside the workspace sandbox (MCP_WORKSPACE_PATH when set, otherwise the system temp directory); paths outside it, `..` traversal, and symlinked targets are refused. By default, refuses to overwrite an existing file — pass overwrite: true to clobber. Overwrites are staged to a temporary sibling file and moved into place only after the download succeeds, so a failed download leaves the existing file untouched.

输入参数url必填overwriteoutput_path必填

opus_get_social_accounts

List the social accounts connected to your Opus organisation. Returns `postAccountId`, `subAccountId` (where applicable), `platform`, and the platform-side `extUser*` identifiers. Use these IDs with opus_publish_post, opus_schedule_post, and opus_create_social_copy_job.

输入参数q

opus_create_social_copy_job

Create an asynchronous social-copy generation job. Opus produces a platform-specific title, description, and hashtags for a clip + destination account. Returns a jobId — poll opus_get_social_copy_job until status is "COMPLETED" or "FAILED".

输入参数clipId必填promptprojectId必填subAccountId必填postAccountId必填forceRegenerate

opus_get_social_copy_job

Poll the status and result of a social-copy generation job. Status values: "RUNNING" (still generating), "COMPLETED" (returns title/description/hashtags), "FAILED". Includes `next_poll_after_seconds` honouring Retry-After.

输入参数jobId必填attempt

opus_publish_post

Publish a clip immediately to a connected social account. For X (formerly Twitter) each post costs 1 credit. Returns a `postId`. The clip is queued for upload by Opus to the destination platform.

输入参数clipId必填projectId必填postDetail必填subAccountIdpostAccountId必填

opus_schedule_post

Schedule a clip for future publishing. `publishAt` must be a future UTC ISO 8601 timestamp (e.g. "2026-06-01T16:00:00.000Z"). For X (formerly Twitter) each post costs 1 credit. Returns a `scheduleId` you can pass to opus_cancel_scheduled_post.

输入参数clipId必填projectId必填publishAt必填postDetail必填subAccountIdpostAccountId必填

opus_cancel_scheduled_post

Cancel a scheduled social post BEFORE its publishAt time. After publishAt the post is irrevocably handed to the platform — cancellation is no longer possible.

输入参数scheduleId必填

版本历史

2
  1. v0.3.0最新Nov 16, 2026
  2. v0.2.1Sep 16, 2026

评分

已满足适用检查项的 80%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。