YouTube MCP Server

YouTube MCP サーバー

YouTube 動画の検索、文字起こしの取得、動画コンテンツのセマンティック検索を行うツールを提供する Model Context Protocol（MCP）サーバーです。

サポートのお願い

このプロジェクトがお役に立ち、今後のプロジェクトも応援したいと思われたら、ぜひコーヒーをごちそうしてください！皆さまのご支援により、革新的な AI ソリューションの開発を続けることができます。

皆さまからのご支援は、インテリジェントで使いやすいアプリケーションを作成する情熱を支える大きな力となります。

目次

• YouTube MCP サーバー
• 機能
• 前提条件
• インストール
• サーバーの実行
  • 1. 直接実行する方法
  • 2. Claude.app 向けの設定
• 利用可能なツール
• MCP クライアントでの使用
  • 使用例
• デバッグ
• コントリビューション
• ライセンス

機能

• 公式 API を使わずに YouTube 動画を検索
• 動画の文字起こしを取得
• 動画情報と文字起こしをベクトルデータベースに保存
• 保存した動画の文字起こしをセマンティック検索

前提条件

• Python 3.8+
• 埋め込み用の Google API キー
• uv パッケージマネージャー

インストール

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

2. uv を使って仮想環境を作成し、有効化します：

uv venv
# On Windows:
.venv\Scripts\activate
# On Unix/MacOS:
source .venv/bin/activate

3. uv を使って依存関係をインストールします：

uv pip install -r requirements.txt

4. Google API キーを記載した .env ファイルを作成します：

GOOGLE_API_KEY=your_api_key_here

サーバーの実行

MCP サーバーを実行する方法は 2 つあります：

1. 直接実行する方法

MCP サーバーを直接起動するには：

uv run python server.py

2. Claude.app 向けの設定

パッケージマネージャーを使わずに Claude の設定に追加します。この方法は Windows で動作します：

"mcpServers": {
  "youtube": {
    "command": "C:\\Path\\To\\Your\\Project\\.venv\\Scripts\\python.exe",
    "args": ["C:\\Path\\To\\Your\\Project\\server.py"],
    "env": {
      "GOOGLE_API_KEY": "your_api_key_here"
    }
  }
}

Uv パッケージマネージャーを使う方法です。この方法は Windows で動作します：

"mcpServers": {
  "youtube": {
    "command": "uv",
    "args": ["--directory", "C:\\Path\\To\\Your\\Project", "run", "server.py"],
    "env": {
      "GOOGLE_API_KEY": "your_api_key_here"
    }
  }
}

利用可能なツール

サーバーは以下のツールを提供します：

1. search-youtube：クエリに基づいて YouTube 動画を検索します

   • パラメーター：
     • query：検索クエリ文字列
     • max_results：返す結果の最大数（デフォルト：5）

2. get-transcript：YouTube 動画の文字起こしを取得します

   • パラメーター：
     • video_url：YouTube 動画の URL

3. store-video-info：動画情報と文字起こしをベクトルデータベースに保存します

   • パラメーター：
     • video_url：YouTube 動画の URL
     • metadata：動画に関する任意のメタデータ

4. search-transcripts：セマンティック検索を使って、保存した動画の文字起こしを検索します

   • パラメーター：
     • query：検索クエリ
     • limit：返す結果の最大数（デフォルト：3）

MCP クライアントでの使用

このサーバーは、Claude Desktop App などの MCP 互換クライアントで使用できます。ツールは自動的に検出され、クライアントで利用できるようになります。

使用例

1. 上記のいずれかの方法でサーバーを起動します
2. Claude Desktop App を開きます
3. ハンマーアイコンを確認し、YouTube ツールが利用可能になっていることを確かめます
4. 次のようなコマンドを使用できます：
   • 「Python のチュートリアル動画を検索して」
   • 「この動画の文字起こしを取得して：[video_url]」
   • 「機械学習に関する保存済みの動画の文字起こしを検索して」

デバッグ

問題が発生した場合：

1. Google API キーが .env ファイルに正しく設定されていることを確認します
2. すべての依存関係が正しくインストールされていることを確認します
3. サーバーが実行中で、接続を待ち受けていることを確認します
4. サーバーの出力にエラーメッセージがないか確認します

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスのもとで公開されています。詳細は LICENSE ファイルをご覧ください。