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 分）
• OPUS_UPLOAD_TIMEOUT_MS — GCS の再開可能なアップロードに対するチャンクごとの HTTP タイムアウト（デフォルトは 600000 ms、最大 30 分）
• OPUS_BRIDGE_TIMEOUT_MS — 任意のホストアプリブリッジに対する HTTP タイムアウト（デフォルトは 30000 ms、最大 30 分）
• 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 — ローカルの動画ファイルをアップロードし、クリッププロジェクトを作成します（GCS の再開可能なアップロードの 4 ステップを実行します。読み取りはワークスペースのサンドボックス内に制限され、破壊的操作としてマークされています）

ダウンロード

• 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 バージョン 1.1。将来 MIT ライセンスに移行します。本ソフトウェアは 2030-05-19 に MIT ライセンスへ移行します。