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 キーを取得してください。このキーは、Cloudglue アカウントで MCP サーバーを認証するために使用します。

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>"
      ]
    }
  }
}

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

B. Desktop Extensions を使用する Claude Desktop

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

ローカル開発

前提条件

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

サーバーのビルド

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

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：個別の動画から、コストをインテリジェントに最適化し、ページネーションにも対応した包括的な文字起こしと説明を取得します。新しい文字起こしを作成する前に、既存の文字起こしを自動で確認します。Cloudglue の URL、YouTube の URL、一般公開されている HTTP 動画 URL、データコネクタの URL（Dropbox、Google Drive、Zoom）など、すべての URL 形式に対応しています。ページネーション：結果は page パラメーターを使って 5 分ごとのセグメントに分割されます（ページ 0 = 最初の 5 分、ページ 1 = 次の 5 分など）。start_time_seconds を使うと、指定した時間インデックスからページネーションを開始できます（デフォルトは 0）。page と組み合わせることで、正確に移動できます。start_time_seconds で基準となるオフセットを設定し、page でそのオフセットから 5 分ごとのセグメントに進みます（例：start_time_seconds=600 で page=0 を指定すると 10～15 分、page=1 を指定すると 15～20 分が返されます）。各レスポンスには、JSON 形式で page、total_pages、description フィールドが含まれます。ページネーションを使うと、扱いやすいサイズのチャンクで説明を取得したり、特定の時間範囲を指定したりして、長い動画を効率的に処理できます。ページネーションは、コレクションの説明（collection_id を使用する場合）と個別の動画の説明の両方で一貫して動作します。

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

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

• segment_video_camera_shots：コストをインテリジェントに最適化しながら、動画をカメラショットに分割します。新しいショット分割ジョブを作成する前に、既存のジョブを自動で確認します。検出された各カメラショットについて、タイムスタンプ、整形済みの時刻、長さを含むセグメント配列を、構造化された JSON の結果として返します。Cloudglue の URL、一般公開されている HTTP 動画 URL、データコネクタの URL（Dropbox、Google Drive、Zoom）に対応しています。注：YouTube の URL はカメラショットの分割に対応していません。

• segment_video_chapters：コストをインテリジェントに最適化しながら、動画をチャプターに分割します。新しいチャプター分割ジョブを作成する前に、既存のジョブを自動で確認します。検出された各チャプターについて、タイムスタンプ、整形済みの時刻、説明を含むチャプター配列を、構造化された JSON の結果として返します。チャプターの検出を誘導するカスタムプロンプトのパラメーターを任意で指定できます。Cloudglue の URL、YouTube の URL、一般公開されている HTTP 動画 URL、データコネクタの URL（Dropbox、Google Drive、Zoom）など、すべての URL 形式に対応しています。

コレクション分析

• 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 を作成
• メール