Youtube MCP Server 9tv

🚀 YouTube MCP サーバー

YouTubeの動画を検索し、字幕を取得し、動画内容に対する意味検索を行うツールを提供するモデルコンテキストプロトコル（MCP）サーバーです。

🤝 支援してください

このプロジェクトがあなたに役立ち、将来のプロジェクトをサポートしたい場合は、コーヒーを一杯奢っていただけると嬉しいです！あなたの支援により、革新的な人工知能ソリューションの構築を続けることができます。

あなたの貢献は、私たちがインテリジェントで使いやすいアプリケーションを作り続ける大きな励みになります。

📚 目次

• YouTube MCP サーバー
• 機能
• 前提条件
• インストール
• サーバーの起動
  • 1. 直接起動する方法
  • 2. Claude.app用に設定する方法
• 利用可能なツール
• MCP クライアントとの連携
  • 使用例
• デバッグ
• コントリビュート
• ライセンス

✨ 主な機能

• 公式APIを使用せずにYouTube動画を直接検索
• 動画の字幕を取得
• 動画情報と字幕をベクトルデータベースに保存
• 保存された動画字幕に対する意味検索

📋 前提条件

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

📦 インストール

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

2. uvを使用して仮想環境を作成し、アクティブ化します。

uv venv
# Windowsの場合:
.venv\Scripts\activate
# Unix/MacOSの場合:
source .venv/bin/activate

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

uv pip install -r requirements.txt

4. .envファイルを作成し、Google APIキーを追加します。

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:\\路径\\to\\your\\uv",
    "args": ["run", "python", "server.py"]
  }
}

💻 利用可能なツール

• server.py：MCPサーバーのメインファイルで、接続とリクエストを処理します。
• config.json：サーバーの設定ファイルで、エンドポイントアドレスやその他の設定が含まれています。

🤝 MCP クライアントとの連携

このサーバーをMCPクライアントと統合するには、MCPプロトコルドキュメントを参照してください。以下は簡単な使用例です。

💻 使用例

基本的な使用法

# サーバーを起動する
uv run python server.py

2. MCPクライアントでYouTube MCPサーバーのアドレスを設定します。

🔧 デバッグ

問題が発生した場合は、以下の手順でトラブルシューティングしてください。

1. .envファイルに正しいGOOGLE_API_KEYが含まれていることを確認します。
2. すべての依存関係が正しくインストールされていることを確認します。
3. サーバーが起動して接続を待機していることを確認します。
4. サーバーの出力にエラーメッセージがあるか確認します。

🤝 コントリビュート

コントリビューションを歓迎します！自由にPull Requestを送信してください。

📄 ライセンス

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