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 分

    請在儲存庫或註冊中心條目中宣告授權條款。