Cloudglue MCP Server

🎬 Cloudglue MCPサーバー

CloudglueをCursor、Claude Desktop、その他のAIアシスタントに接続し、動画コレクション理解の力を引き出します。Cloudglueは、動画をLLMで利用可能な構造化データに変換するのに役立ちます。

📖 リソース

• Model Context Protocol
• Cloudglue APIドキュメント
• 利用規約
• プライバシーポリシー
• 料金

Cloudglue SDKおよび/またはMCPサーバーを使用することにより、Cloudglue利用規約に同意し、プライバシーポリシーを承認したものとみなされます。

🚀 使い方

前提条件

まず、cloudglue.devからCloudglue APIキーを取得してください。これは、MCPサーバーをCloudglueアカウントで認証するために使用されます。

A. JSON設定を使用するMCPクライアント

ほとんどのMCPクライアントは設定をJSONとして保存します。cloudglue-mcp-serverの場合、以下のようになります：

{
  "mcpServers": {
    "cloudglue": {
      "command": "npx",
      "args": [
        "-y",
        "@cloudglue/cloudglue-mcp-server@latest",
        "--api-key",
        "<CLOUDGLUE-YOUR-API-KEY>"
      ]
    }
  }
}

<CLOUDGLUE-YOUR-API-KEY>を先ほど作成したAPIキーに置き換えてください。

B. デスクトップ拡張機能を使用したClaude Desktop

1. リリースページから最新のCloudglue Claude Desktop拡張機能をダウンロードします
2. Claude Desktopで開くためにダブルクリックします（事前にClaude Desktopを起動しておく必要があります）
3. 「Install」をクリックします
4. プロンプトが表示されたら、APIキーを入力します
5. 拡張機能を有効にします

🛠️ ローカル開発

前提条件

まず、cloudglue.devからCloudglue APIキーを取得してください。これは、MCPサーバーをCloudglueアカウントで認証するために使用されます。

サーバーのビルド

1. リポジトリをクローンします
2. npm installを使用して依存関係をインストールします
3. npm buildを使用してサーバーとClaude Desktop拡張機能をビルドします

MCPクライアントの設定

次に、このサーバーを使用するようにMCPクライアント（Cursorなど）を設定します。ほとんどのMCPクライアントは、設定を以下の形式のJSONとして保存します：

{
  "mcpServers": {
    "cloudglue-mcp-server": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/cloudglue-mcp-server/build/index.js",
        "--api-key",
        "<CLOUDGLUE-YOUR-API-KEY>"
      ]
    }
  }
}

📚 ドキュメント

サポートされるURL形式

Cloudglue MCPサーバーは、動画分析のために複数のURL形式をサポートしています：

Cloudglueプラットフォーム（デフォルト）

• 形式: cloudglue://files/file-id
• 使用方法: list_videosツールで取得したファイルIDを使用します
• 最適な用途: すでにCloudglueにアップロード済みの動画

YouTube URL

• 形式:
  • https://www.youtube.com/watch?v=...
  • https://youtu.be/...
• サポートされるツール: describe_video、extract_video_entities、segment_video_chapters
• 注意: segment_video_camera_shotsではサポートされていません

公開HTTP動画URL

• 形式: MP4ファイルへの直接リンク（例：https://example.com/video.mp4）
• 最適な用途: 公開アクセス可能な動画ファイル

データコネクタURL

Cloudglueアカウントでの設定が必要です - データコネクタのドキュメントを参照してください

• Dropbox:

  • 共有リンク: https://www.dropbox.com/scl/fo/SOME_ID/SOME_OTHER_ID?rlkey=SOME_KEY&st=SOME_TIME&dl=0
  • 直接パス: dropbox://<path>/<to>/<file>

• Google Drive:

  • 形式: gdrive://file/<file_id>

• Zoom:

  • 会議UUID: zoom://uuid/QFwZYEreTl2e6MBFSslXjQ%3D%3D
  • 会議ID: zoom://id/81586198865

ツール

以下のCloudglueツールが、このMCPサーバーを通じてLLMで利用可能です：

検出とナビゲーション

• list_collections: 利用可能な動画コレクションとその基本メタデータを検出します。他のコレクション固有のツールを使用する前に、まずこれを使用してどのような動画コレクションが存在するかを把握してください。他のツールに必要なコレクションID、動画数、コレクションタイプを表示します。タイプが'media-descriptions'のコレクションでは、collection_idパラメータを指定してdescribe_videoを使用し、特定のCloudglueファイルに対して以前に抽出された説明を取得します。タイプが'entities'のコレクションでは、collection_idパラメータを指定してextract_video_entitiesを使用し、特定のCloudglueファイルに対して以前に抽出されたエンティティを取得します。ページネーション: 結果はpageパラメータを使用して1ページあたり25コレクションでページ分割されます（page 0 = 最初の25コレクション、page 1 = 次の25コレクション、など）。各レスポンスにはpageフィールドとtotal_pagesフィールドが含まれます。包括的な探索のために、すべてのページを取得するまでpageパラメータをインクリメントしてすべてのコレクションをページ分割してください。

• list_videos: 強力なフィルタリングオプションを使用して動画メタデータを閲覧・検索します。利用可能な動画を探索したり、日付で特定のコンテンツを検索したり、コレクションに何が含まれているかを確認するためにこれを使用します。他のツールに必要な再生時間、ファイル名、IDなどの重要な動画情報を返します。ページネーション: 結果はpageパラメータを使用して1ページあたり25動画でページ分割されます（page 0 = 最初の25動画、page 1 = 次の25動画、など）。各レスポンスにはpageフィールドとtotal_pagesフィールドが含まれます。日付フィルタリングを使用して特定の期間に焦点を当て、その結果内でページ分割します。

個別動画の分析

• describe_video: インテリジェントなコスト最適化とページネーションサポートにより、個別動画から包括的なトランスクリプトと説明を取得します。新しいものを作成する前に、既存のトランスクリプトを自動的にチェックします。すべてのURL形式をサポートします：Cloudglue URL、YouTube URL、公開HTTP動画URL、データコネクタURL（Dropbox、Google Drive、Zoom）。ページネーション: 結果はpageパラメータを使用して5分単位のセグメントでページ分割されます（page 0 = 最初の5分、page 1 = 次の5分、など）。start_time_secondsを使用して特定の時間インデックスからページネーションを開始します（デフォルトは0）。pageと組み合わせることで、正確なナビゲーションが可能になります：start_time_secondsはベースオフセットを設定し、pageはそのオフセットから5分単位でインクリメントします（例：start_time_seconds=600とpage=0は10〜15分、page=1は15〜20分を返します）。各レスポンスにはpage、total_pages、descriptionフィールドがJSON形式で含まれます。ページネーションを使用して、長い動画を管理可能なチャンクで説明を取得して効率的に処理したり、特定の時間範囲をターゲットにしたりします。ページネーションは、コレクションの説明（collection_idを使用する場合）と個別動画の説明の両方で一貫して機能します。

• extract_video_entities: インテリジェントなコスト最適化とページネーションサポートにより、カスタムプロンプトを使用して動画から構造化データとエンティティを抽出します。新しいものを作成する前に、既存の抽出を自動的にチェックします。すべてのURL形式をサポートします：Cloudglue URL、YouTube URL、公開HTTP動画URL、データコネクタURL（Dropbox、Google Drive、Zoom）。結果の品質はプロンプトの具体性に大きく依存します。ページネーション: セグメントレベルのエンティティはpageパラメータを使用してページ分割されます（1ページあたり25セグメント）。各レスポンスにはvideo_level_entitiesとsegment_level_entitiesが含まれ、entities、page、total_pagesフィールドがJSON形式で含まれます。

• get_video_metadata: 再生時間、解像度、ファイルサイズ、処理ステータス、計算された統計など、Cloudglue動画ファイルに関する包括的な技術メタデータを取得します。完全なファイルメタデータ、動画情報（解像度、fps、コーデックなど）、処理タイムスタンプ、計算されたフィールドを含む構造化JSON結果を返します。コンテンツ分析ではなく、動画の仕様、ファイルの詳細、処理情報が必要な場合にこれを使用します。describe_videoのようなコンテンツ重視のツールとは異なります。

• segment_video_camera_shots: インテリジェントなコスト最適化により、動画をカメラショットに分割します。新しいものを作成する前に、既存のショットセグメンテーションジョブを自動的にチェックします。検出された各カメラショットのタイムスタンプ、フォーマットされた時間、再生時間を含むsegments配列を持つ構造化JSON結果を返します。Cloudglue URL、公開HTTP動画URL、データコネクタURL（Dropbox、Google Drive、Zoom）をサポートします。注意：YouTube URLはカメラショットセグメンテーションではサポートされていません。

• segment_video_chapters: インテリジェントなコスト最適化により、動画をチャプターに分割します。新しいものを作成する前に、既存のチャプターセグメンテーションジョブを自動的にチェックします。検出された各チャプターのタイムスタンプ、フォーマットされた時間、説明を含むchapters配列を持つ構造化JSON結果を返します。チャプター検出をガイドするために、オプションのカスタムプロンプトパラメータをサポートします。すべてのURL形式をサポートします：Cloudglue URL、YouTube URL、公開HTTP動画URL、データコネクタURL（Dropbox、Google Drive、Zoom）。

コレクション分析

• retrieve_summaries: コレクションから動画の要約とタイトルを一括取得し、その内容とテーマをすばやく理解します。rich-transcriptsコレクションとmedia-descriptionsコレクションの両方で機能します。コレクションに何が含まれているかの概要を把握したり、一般的なトピックを特定したり、特定のクエリに関連するコンテンツがコレクションに含まれているかを判断したりするのに最適です。コレクションを分析する際の最初のステップとしてこれを使用してください。完全な説明を取得するよりも効率的で、より詳細な情報が必要かどうかを判断するのに役立ちます。ターゲットを絞ったコンテンツ発見には、すべての要約を閲覧する代わりにsearch_video_summariesまたはsearch_video_momentsの使用を検討してください。ページネーション: 結果はpageパラメータを使用して1ページあたり25要約でページ分割されます（page 0 = 最初の25要約、page 1 = 次の25要約、など）。各レスポンスにはpageフィールドとtotal_pagesフィールドが含まれます。包括的なコレクション分析のために、すべてのページを取得するまでpageパラメータをインクリメントしてすべての要約をページ分割してください。

• search_video_moments: コレクション内の特定の動画セグメントを見つけるためのAI駆動のセマンティック検索。Cloudglueの検索APIを使用して、音声、画面上のテキスト、視覚的な説明にわたる関連する瞬間を特定します。タイムスタンプとメタデータを含む構造化検索結果を返します。干し草の中の針のような音声および視覚コンテンツ、特定の議論、テーマ分析を見つけるのに最適です。クエリごとに最大20の関連する動画の瞬間を返します。

• search_video_summaries: コレクション内の関連動画を見つけるためのAI駆動のセマンティック検索。Cloudglueの検索APIを使用して、動画の内容、要約、メタデータに基づいて動画を特定します。rich-transcriptsコレクションとmedia-descriptionsコレクションで機能します。動画情報と関連性スコアを含む構造化検索結果を返します。トピック、テーマ、コンテンツの類似性で動画を発見するのに最適です。クエリごとに最大20の関連動画を返します。

ページネーション戦略

いつ徹底的にページ分割するか：

• ユーザーがコレクション/動画の「すべて」または「完全な」分析を求めた場合
• ユーザーが包括的なカバレッジや徹底的な探索を求めた場合
• ユーザーがデータマイニング、データセット構築、完全なエンティティ抽出を要求した場合
• ユーザーがコレクションまたは期間内の「すべて」を求めた場合

ページ分割の方法：

すべてのツールはページベースのページネーションを使用します（list_collections、list_videos、describe_video、extract_video_entities、retrieve_summaries）：

1. 最初のリクエストから開始します（page=0）
2. レスポンスのtotal_pagesフィールドを確認します
3. page < total_pages - 1の場合、pageをインクリメントして繰り返します
4. すべてのページを取得するか、十分なデータが得られるまで続けます

ツールごとのページサイズ：

• list_collections: 1ページあたり25コレクション
• list_videos: 1ページあたり25動画
• describe_video: 1ページあたり5分
• extract_video_entities: 1ページあたり25セグメントエンティティ
• retrieve_summaries: 1ページあたり25要約

どのツールをいつ使うか

• 探索を開始する: list_collectionsとlist_videosを使用して利用可能なコンテンツを探索します
• 単一の動画の場合: describe_video、extract_video_entities、segment_video_camera_shots、またはsegment_video_chaptersを使用します
• コレクションの概要の場合: 常にretrieve_summariesから始めて、コレクションに何が含まれているかを効率的に理解します
• 詳細な分析の場合: 要約を通じて特定された、完全なマルチモーダルコンテキストを必要とする特定の動画にはdescribe_videoを使用します
• 構造化データの場合: 個別動画からのエンティティ抽出にはextract_video_entitiesを使用します
• 特定のコンテンツの場合: ターゲットを絞ったセグメント検索にはsearch_video_moments、動画レベルの検索にはsearch_video_summariesを使用します
• 技術仕様の場合: get_video_metadataを使用します

すべてのツールには、コスト最適化、自動フォールバック、包括的なエラー処理などのインテリジェントな機能が含まれています。

📞 お問い合わせ

• Issueを作成する
• メール