Youtube Vision

YouTube Vision MCP Server (youtube-vision)

Google Gemini Vision API を利用して YouTube 動画とやり取りする MCP（Model Context Protocol）サーバーです。YouTube 動画の説明や要約、質問への回答を取得したり、重要な場面を抽出したりできます。

特長

• Gemini Vision API を使用して YouTube 動画を分析します。
• 用途に応じて複数のツールを提供します。
  • 一般的な説明または Q&A（ask_about_youtube_video）
  • 要約（summarize_youtube_video）
  • 重要な場面の抽出（extract_key_moments）
• generateContent に対応する Gemini モデルを一覧表示します。
• 環境変数を使用して Gemini モデルを設定できます。
• stdio（標準入出力）経由で通信します。

前提条件

このサーバーを使用する前に、以下を用意してください。

• Node.js： バージョン 18 以降を推奨します。nodejs.org からダウンロードできます。
• Google Gemini API キー： Google AI Studio または Google Cloud Console から API キーを取得してください。

インストールと使い方

このサーバーを使用する主な方法は 2 つあります。

Smithery 経由でインストールする

Smithery 経由で Claude Desktop に youtube-vision-mcp を自動的にインストールするには：

npx -y @smithery/cli install @minbang930/youtube-vision-mcp --client claude

オプション 1：npx を使用する（手軽に使う場合に推奨）

このサーバーを実行する最も簡単な方法は npx を使用することです。恒久的にインストールする必要はなく、パッケージをダウンロードして実行します。

MCP クライアントの設定ファイル（Claude、VSCode など）で設定できます。

{
  "mcpServers": {
    "youtube-vision": {
      "command": "npx",
      "args": [
        "-y",
        "youtube-vision"
      ],
      "env": {
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY",
        "GEMINI_MODEL_NAME": "gemini-2.0-flash"
      }
    }
  }
}

"YOUR_GEMINI_API_KEY" を実際の Google Gemini API キーに置き換えてください。

オプション 2：手動インストール（ソースから）

コードを変更する場合、またはソースから直接実行する場合：

1. リポジトリをクローンします：

   git clone https://github.com/minbang930/Youtube-Vision-MCP.git
   cd youtube-vision
   

2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

4. 設定して実行します： node dist/index.js を使用して、コンパイル済みのコードを直接実行できます（GEMINI_API_KEY が環境変数として設定されていることを確認してください）。または、npx の例のように env 設定で API キーを渡し、node コマンドと dist/index.js の絶対パスを使用して実行するよう MCP クライアントを設定できます。

設定

このサーバーでは、以下の環境変数を使用します。

• GEMINI_API_KEY（必須）：Google Gemini API キーです。
• GEMINI_MODEL_NAME（任意）：使用する Gemini モデル（例：gemini-1.5-flash）です。デフォルトは gemini-2.0-flash です。重要： 本番環境または商用利用では、「Experimental」または「Preview」と表示されていないモデルバージョンを選択してください。

環境変数は、MCP クライアントの設定ファイル（例：mcp_settings.json）の env セクションで設定してください。

利用可能なツール

1. ask_about_youtube_video

動画についての質問に回答します。質問がない場合は、一般的な説明を提供します。

• 入力：
  • youtube_url（文字列、必須）：YouTube 動画の URL です。
  • question（文字列、任意）：動画について質問する内容です。省略すると、一般的な説明が生成されます。
• 出力： 回答または説明を含むテキスト。

2. summarize_youtube_video

指定された YouTube 動画の要約を生成します。

• 入力：
  • youtube_url（文字列、必須）：YouTube 動画の URL。
  • summary_length（文字列、任意）：希望する要約の長さ（'short'、'medium'、'long'）。デフォルトは 'medium' です。
• **出力：**動画の要約を含むテキスト。

3. extract_key_moments

指定された YouTube 動画から重要な場面（タイムスタンプと説明）を抽出します。

• 入力：
  • youtube_url（文字列、必須）：YouTube 動画の URL。
  • number_of_moments（整数、任意）：抽出する重要な場面の数。デフォルトは 3 です。
• **出力：**タイムスタンプ付きで重要な場面を説明するテキスト。

4. list_supported_models

generateContent メソッドに対応する利用可能な Gemini モデルを一覧表示します（REST API 経由で取得）。

• **入力：**なし
• **出力：**対応モデル名を一覧表示するテキスト。

重要な注意事項

• **本番環境でのモデル選択：**このサーバーを本番環境または商用目的で使用する場合は、選択した GEMINI_MODEL_NAME が本番環境での使用に適した安定版であることを確認してください。Gemini API の利用規約に従い、「Experimental」または「Preview」と表示されたモデルは、本番環境へのデプロイには使用できません。
• **API の利用規約：**このサーバーの使用には Google Gemini API が必要です。ユーザーは、Google APIs 利用規約および Gemini API 追加利用規約を確認し、遵守する責任を負います。Gemini API の無料プランと有料プランでは、データの使用ポリシーが異なる場合があることにご注意ください。無料プランを使用する際は、機密情報や秘密情報を送信しないでください。
• **コンテンツに関する責任：**Gemini API によって生成されるコンテンツの正確性や適切性は保証されません。生成されたコンテンツを信頼したり、公開したりする前に、慎重に判断してください。

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については LICENSE ファイルを参照してください。